home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / udbsv540.arc / UDBS.DOC < prev    next >
Text File  |  1991-05-03  |  121KB  |  2,869 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                             The User Database System
  30.                                    Version 5.4
  31.                                    April 1991
  32.  
  33.                                 For PCBoard 14.5a
  34.  
  35.                                  Operators Guide
  36.  
  37.                         Copyright (C) Jeff Sumberg, 1987 - 1991
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                 Table Of Contents
  44.  
  45.      The User Database System  . . . . . . . . . . . . . . . . . . . .    5
  46.  
  47.      User Supported Software License . . . . . . . . . . . . . . . . .    5
  48.  
  49.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . .    6
  50.  
  51.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . .    6
  52.  
  53.      System Requirements . . . . . . . . . . . . . . . . . . . . . . .    7
  54.  
  55.      Operational Restrictions  . . . . . . . . . . . . . . . . . . . .    8
  56.  
  57.      Configuration . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  58.           INPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  59.           OUTPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  60.           UPDATE=YES . . . . . . . . . . . . . . . . . . . . . . . . .   10
  61.           USEACTBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   12
  62.           PURIFYBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   12
  63.           FILES= . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  64.           NEW=YES  . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  65.           USERS= . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  66.           PCBNDX=  . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  67.           NEWADDITIONS=NO  . . . . . . . . . . . . . . . . . . . . . .   13
  68.           MBQ= . . . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  69.           BULLETINx= . . . . . . . . . . . . . . . . . . . . . . . . .   14
  70.           VERSION= . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  71.           SINGLENODE . . . . . . . . . . . . . . . . . . . . . . . . .   16
  72.           OVERLAPCHECK=NO  . . . . . . . . . . . . . . . . . . . . . .   16
  73.           LOG= . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  74.           EVENT  . . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  75.           REPORT=  . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  76.           COLOR=NO . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  77.           DOS PATH . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  78.  
  79.      Text and Language Configuration . . . . . . . . . . . . . . . . .   19
  80.           Languages= . . . . . . . . . . . . . . . . . . . . . . . . .   19
  81.           LanguageX= . . . . . . . . . . . . . . . . . . . . . . . . .   19
  82.           Language File Format . . . . . . . . . . . . . . . . . . . .   20
  83.           Text Matching Rules  . . . . . . . . . . . . . . . . . . . .   21
  84.  
  85.      Program Operation - Useact  . . . . . . . . . . . . . . . . . . .   23
  86.           Storage Available  . . . . . . . . . . . . . . . . . . . . .   23
  87.           Running Useact In Event.Sys  . . . . . . . . . . . . . . . .   23
  88.           Error Handling In Useact . . . . . . . . . . . . . . . . . .   23
  89.           Useact's Command line mode . . . . . . . . . . . . . . . . .   24
  90.  
  91.      Program Operation - Query . . . . . . . . . . . . . . . . . . . .   25
  92.           User Statistics  . . . . . . . . . . . . . . . . . . . . . .   25
  93.           Users Who Never Download . . . . . . . . . . . . . . . . . .   25
  94.           Users Who Never Upload . . . . . . . . . . . . . . . . . . .   25
  95.  
  96.      UDBS Version 5.4                                                Page 2
  97.  
  98.  
  99.  
  100.  
  101.  
  102.           File Transfers During a Specific Period  . . . . . . . . . .   26
  103.           Users With Keyboard Timeout Disconnects  . . . . . . . . . .   26
  104.           Users Disconnected For Daily Time Limit  . . . . . . . . . .   26
  105.           Users That Downloaded A Specific File  . . . . . . . . . . .   26
  106.           Who Uploaded A Specific File . . . . . . . . . . . . . . . .   26
  107.           All Files Downloaded By A Specific User  . . . . . . . . . .   26
  108.           All Files Uploaded By A Specific User  . . . . . . . . . . .   26
  109.           Display Period Totals  . . . . . . . . . . . . . . . . . . .   27
  110.           Users Exceeding DL/UL Ratio  . . . . . . . . . . . . . . . .   27
  111.           Users That Never Left A Message  . . . . . . . . . . . . . .   27
  112.           Doors and Node Chat  . . . . . . . . . . . . . . . . . . . .   27
  113.           Users With Security Violations . . . . . . . . . . . . . . .   28
  114.           Baud Rates and Protocols . . . . . . . . . . . . . . . . . .   29
  115.           Users That Page Sysop  . . . . . . . . . . . . . . . . . . .   29
  116.           Show New Users On Specified Date . . . . . . . . . . . . . .   29
  117.           Scan For User Name . . . . . . . . . . . . . . . . . . . . .   29
  118.           Generate Reports . . . . . . . . . . . . . . . . . . . . . .   29
  119.  
  120.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . .   30
  121.           Delete User  . . . . . . . . . . . . . . . . . . . . . . . .   30
  122.           Delete If Not In User File . . . . . . . . . . . . . . . . .   30
  123.           Purify Files . . . . . . . . . . . . . . . . . . . . . . . .   30
  124.           Undelete User  . . . . . . . . . . . . . . . . . . . . . . .   31
  125.           Add Download Credit  . . . . . . . . . . . . . . . . . . . .   32
  126.           Add Upload Credit  . . . . . . . . . . . . . . . . . . . . .   32
  127.           Delete Download Credit . . . . . . . . . . . . . . . . . . .   32
  128.           Delete Upload Credit . . . . . . . . . . . . . . . . . . . .   32
  129.           Database Size Information  . . . . . . . . . . . . . . . . .   32
  130.           Change User Name . . . . . . . . . . . . . . . . . . . . . .   32
  131.           Subscriptions  . . . . . . . . . . . . . . . . . . . . . . .   33
  132.           Comments . . . . . . . . . . . . . . . . . . . . . . . . . .   33
  133.           Rebuild Index Files  . . . . . . . . . . . . . . . . . . . .   34
  134.           Reset Bulletin Flag  . . . . . . . . . . . . . . . . . . . .   34
  135.           Merge Two Data Records . . . . . . . . . . . . . . . . . . .   35
  136.  
  137.      Problems & Support  . . . . . . . . . . . . . . . . . . . . . . .   36
  138.  
  139.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .   36
  140.  
  141.      Disclaimer/Warranty . . . . . . . . . . . . . . . . . . . . . . .   37
  142.  
  143.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . .   37
  144.  
  145.      Appendix A - Getting Your Database Started  . . . . . . . . . . .   38
  146.  
  147.      Appendix B - The NewCalls Utility Program . . . . . . . . . . . .   39
  148.  
  149.      Appendix C - Setup For Multiple Node Systems  . . . . . . . . . .   41
  150.  
  151.      Appendix D - The Sync Utility . . . . . . . . . . . . . . . . . .   43
  152.  
  153.      Appendix E - Common Problems  . . . . . . . . . . . . . . . . . .   44
  154.  
  155.      UDBS Version 5.4                                                Page 3
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.      Appendix F - What Registered Users Get  . . . . . . . . . . . . .   46
  163.  
  164.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   47
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.      UDBS Version 5.4                                                Page 4
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                             The User Database System
  221.  
  222.      This collection of programs will enable you, the Sysop, to better
  223.      manage and monitor the activity of your users. The User Database
  224.      System brings together a call analyzer, a database, and a menu driven
  225.      query system that puts important user information at your disposal.
  226.      Immediately. All information on users is obtained from the CALLER file
  227.      generated by PCBoard. The major difference between the User Database
  228.      System and a standard call analyzer is that the User Database System
  229.      generates statistics on an individual user basis. 
  230.  
  231.      Some of the operations and features of the User Database System in-
  232.      clude:
  233.  
  234.           * View a users statistics
  235.           * View all files downloaded (or uploaded) by a user
  236.           * View all users that downloaded a specific file
  237.           * Find users exceeding UL/DL ratios
  238.           * Generate reports for posting in bulletins
  239.           * Fully text configurable and language independent
  240.           * Door programs and utilities for registered users
  241.           * And much more
  242.  
  243.  
  244.                          User Supported Software License
  245.  
  246.      The User Database System is not public domain, and it is not free
  247.      software, it is user supported. Non-registered users are given a
  248.      reasonable period of time to try the programs out and determine if
  249.      they meets their needs, after this period you must register your copy
  250.      or discontinue its use. If these programs are used in a commercial en-
  251.      vironment, then you must register it. Registration of the User
  252.      Database System is $25.00. User registrations are what keeps this
  253.      program going. This program was developed because of a "need to know"
  254.      situation. It represents many months of work, and thousands of lines
  255.      of code. I hope that you will find this program useful in the
  256.      management of your bulletin board system.  Remember, only you, the end
  257.      user, can make the Shareware concept work. Please register your copy!
  258.  
  259.      Please send payments and/or comments to:
  260.  
  261.                                   Jeff Sumberg
  262.                                     box 212 
  263.                               Ringwood, N.J. 07456
  264.  
  265.      After you have registered, I will send you two Door programs and a
  266.      variety of utility programs that enhance the use of this database
  267.      system. Please see Appendix F for a description of these programs.
  268.  
  269.      Registered users get support via the SailBoard BBS. When you register
  270.      with me be sure to include the name of your system EXACTLY
  271.      (upper/lower case) as you would like it to appear in the door pro-
  272.  
  273.      UDBS Version 5.4                                                Page 5
  274.  
  275.  
  276.  
  277.  
  278.  
  279.      grams, this name is hard coded and cannot be changed at your end. Also
  280.      I will automatically register you as a visiting Sysop and UDBS user on
  281.      the SailBoard BBS, so please send me the password that you would like
  282.      to use.
  283.  
  284.                             Copying and Distribution
  285.  
  286.      The User Database System is a copyrighted program that is being dis-
  287.      tributed as user supported software. It may be copied and distributed
  288.      freely as long as all terms of the license are followed. All files (as
  289.      mentioned here in the manual) must be included as a set. No fee other
  290.      than a disk and handling charge (of up to $5.00) may be charged.
  291.  
  292.                               Distribution Contents
  293.  
  294.      USEACT.EXE     The call analyzer
  295.      ENGLISH.UDB    Standard english language text scan list
  296.      QUERY.EXE      The database query program
  297.      MODIFY.EXE     The file maintenance functions for Query
  298.      SYNC.EXE       Utility to Synchronize database to Users file
  299.      NEWCALLS.EXE   Utility to facilitate daily database updates
  300.      UDBS.CFG       Sample configuration file
  301.      UDBS50.EXE     A custom Basic Compiler run-time library
  302.      UDBS.DOC       This file
  303.      READ.ME        If included, contains important information about this
  304.                     release. It should be read FIRST before doing anything
  305.                     else. Any additional files in the distribution will be
  306.                     explained here.
  307.  
  308.      USEACT.EXE     This is the analyzer program. This program reads the
  309.                     caller log and separates all the activities of each
  310.                     user. The results of which are optionally written to a
  311.                     report file and/or optionally written to the database.
  312.                     In this way, reports can be generated at any time
  313.                     without affecting the database (or Visa-Versa).
  314.  
  315.      ENGLISH.UDB    This file contains all the items that are scanned for
  316.                     by the Useact program. These are the standard entries
  317.                     from the stock PCBTEXT file. If you customize PCBTEXT,
  318.                     then you change the respective lines in this file. See
  319.                     section on Text/Language configuration.
  320.  
  321.      QUERY.EXE      This program is used to examine the information stored
  322.                     in the database. 
  323.  
  324.      MODIFY.EXE     This program contains all the file maintenance func-
  325.                     tions of Query. (This program is chained to by Que-
  326.                     ry.Exe and is not intended to be run from the command
  327.                     line).
  328.  
  329.      SYNC.EXE       This utility is used to synchronize the Upload, Downlo-
  330.                     ad, and Times On System values to correspond with the
  331.  
  332.      UDBS Version 5.4                                                Page 6
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                     values already in you system Users file. This program
  339.                     can be run interactively or in a batch mode
  340.                     (Event.Sys). For more information see Appendix D.
  341.  
  342.      NEWCALLS.EXE   This utility is used to facilitate daily database
  343.                     updates during your event. This programs 'remembers'
  344.                     where the last place in the callers log was when the
  345.                     previous event ran and extracts all call records from
  346.                     that point on. Appendix B has more information.
  347.  
  348.      UDBS.CFG       This is a sample configuration file containing paramet-
  349.                     ers used to control all of the programs. The contents
  350.                     of this file are explained in detail in the chapter on
  351.                     configuration. You will probably have to customize this
  352.                     file to your system.
  353.  
  354.      UDBS50.EXE     This is custom Basic run-time library. It is required
  355.                     by ALL programs. This is NOT an executable program even
  356.                     though it bears the an EXE extension. Running it will
  357.                     only produce its version number. This file can be kept
  358.                     anywhere on your system on any drive, as long as it is
  359.                     within your current PATH specification at run-time. If
  360.                     this file cannot be found, you will receive a prompt
  361.                     asking for its location. Probably the best place to put
  362.                     it is in the same subdirectory as the programs.
  363.  
  364.  
  365.                                System Requirements
  366.  
  367.      These programs require a minimum 250k of memory to operate. The
  368.      programs all operate in text mode with or without color (color is
  369.      selected automatically if a color card is sensed and may be disabled
  370.      if desired). Therefore any type of monitor/display card combination is
  371.      acceptable. At one time or another, some of these programs will have
  372.      as many as 13 files open. Given the fact that Dos always has the first
  373.      five files open for the standard input and output devices, you will
  374.      need a Files= statement in your Config.Sys file (Of at least
  375.      Files=20). Dos version 3.x is also required for the file sharing
  376.      support. These programs have been tested on, and are being used with
  377.      DoubleDos, Taskview, Alloy's PC/slave card with NTNX, DESQview, and
  378.      Microsoft Windows on True PC's, XT's, AT's, PS/2's, 386 systems, and
  379.      various clones. I do not however guarantee that these program will
  380.      work under every conceivable hardware and software configuration, but
  381.      they seem to work fine under many different configurations on MANY
  382.      different systems.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.      UDBS Version 5.4                                                Page 7
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                             Operational Restrictions
  399.  
  400.                          !!!PLEASE READ THIS SECTION!!!
  401.  
  402.      THE PROGRAMS IN THIS RELEASE WERE DESIGNED TO OPERATE WITH PCBOARD
  403.      VERSION 14 AND PREVIOUS RELEASES (TO VERSION 10). USE OF THESE
  404.      PROGRAMS ON ANY FUTURE RELEASES MAY PRODUCE UNDESIRABLE OR UNPREDIC-
  405.      TABLE RESULTS, INCLUDING BUT NOT LIMITED TO, IRREVERSIBLE DATA FILE
  406.      DAMAGE. IF YOU PLAN TO USE THIS VERSION OF THE USER DATABASE SYSTEM ON
  407.      ANY FUTURE RELEASES OF PCBOARD, YOU SHOULD TAKE ADEQUATE STEPS TO
  408.      PROTECT YOUR DATA BEFORE YOU DO SO. A BACKUP OF ALL THE DATA FILES
  409.      SHOULD BE MADE BEFORE RUNNING ANY QUESTIONABLE CALLERS LOGS THROUGH
  410.      THESE PROGRAMS, THIS WAY YOU ARE PROTECTED AGAINST ANY UNFORESEEN
  411.      CHANGES IN PCBOARD NOT EXPECTED BY THESE PROGRAMS. THINGS YOU SHOULD
  412.      BE MOST AWARE OF AT EACH NEW RELEASE ARE CHANGES TO THE CALLERS LOG,
  413.      SINCE THIS IS WHERE ALL INFORMATION IS EXTRACTED FROM. IT TAKES SOME
  414.      TIME IN ORDER TO ANALYZE WHAT EFFECT ANY TYPE OF CHANGE WILL CREATE,
  415.      AND YOU SHOULD BE PREPARED IN THE EVENT THESE PROGRAMS FUNCTION
  416.      ABNORMALLY. 
  417.  
  418.      THESE PROGRAMS DO NOT, AND WILL NOT, SUPPORT ANY BETA RELEASES OF
  419.      PCBOARD THAT MAY BE AVAILABLE NOW, OR IN THE FUTURE. IF YOU PLAN TO
  420.      RUN THESE PROGRAMS WITH PCBOARD BETA SOFTWARE THAT MIGHT BE RELEASED,
  421.      YOU DO SO ENTIRELY AT YOUR OWN RISK.
  422.  
  423.      THE USE OF INDEXED FILES REQUIRES MORE CARE ON YOUR PART THAN WITH
  424.      PREVIOUS VERSIONS. DUE TO THE NATURE OF THESE FILES, THEY ARE MORE
  425.      SUBJECT TO DAMAGE THAN FILE STRUCTURES USED IN PREVIOUS VERSIONS.
  426.      UNDER NO CIRCUMSTANCES SHOULD THESE PROGRAMS BE TERMINATED IN A METHOD
  427.      OTHER THAN THAT PROVIDED FOR EXITING. 
  428.  
  429.      The new XRF files used a linked chain scheme similar to the FAT used
  430.      on disks. This is where the increased speed is realized by not reading
  431.      any records not associated by the user being queried. However, like
  432.      the FAT on a disk, once damaged, is impossible to repair. If for some
  433.      reason your computer should lock up, reboot, or loose power while
  434.      USEACT, MODIFY, or DOWNCRED/UPCRED is running and in the process of
  435.      MODIFYING files, there is a very good possibility that either your
  436.      data files or the index files will be damaged. Therefor you should
  437.      ALWAYS keep a current backup. Follow this rule of thumb: if the above
  438.      does happen (lockup/boot/power loss), ASSUME THE FILES TO BE DAMAGED,
  439.      and use your latest backup copy, bringing it up to date. Signs of
  440.      damaged chains are "Bad Record Number" or "Error 64", index file
  441.      damage may cause all sorts of odd operation. Under normal operating
  442.      conditions you should never see this, but it is your responsibility to
  443.      be prepared for it.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.      UDBS Version 5.4                                                Page 8
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                   Configuration
  457.  
  458.      All of these programs use a configuration file to set options and
  459.      locate files. This file, UDBS.CFG must be present in the current
  460.      directory(1) whenever one of the programs is run, or an error message
  461.      will be issued. Refer to the sample configuration file that came with
  462.      the distribution.
  463.  
  464.         IMPORTANT:   In the following examples, please notice that there is
  465.                      no space on either side of the equal (=) sign.
  466.                      Improper operation will result if spaces are used.
  467.  
  468.      INPUT=fname
  469.  
  470.           This line is used by Useact.Exe to specify the name of the
  471.           callers log. The INPUT= parameter is REQUIRED, and can only
  472.           specify ONE file. If you put more than one input statement in
  473.           your config file, only the last one will be used. Typical entries
  474.           might be:
  475.  
  476.              INPUT=CALLER
  477.              INPUT=CALLER1
  478.              INPUT=C:\PCB\MAIN\CALLERS
  479.  
  480.           If more than one log file needs to be processed, as is the case
  481.           in multiple node systems, their names may be supplied via an
  482.           indirect file. This is done by placing an '@' in front of the
  483.           filename:
  484.  
  485.              INPUT=@MYLOGS
  486.  
  487.           In this example, MYLOGS is a file that will contain the names of
  488.           the logs to process. Each line of MYLOGS will contain the name of
  489.           ONE log file (with any required paths). MYLOGS is a text file
  490.           with each line terminated in a CR/LF. MYLOGS should look like
  491.           this:
  492.  
  493.              [/path/]log1
  494.              [/path/]log2
  495.              [/path/]log3
  496.                 .
  497.                 .
  498.              [/path/]logn
  499.  
  500.           You can process as many log files as you like in this manner with
  501.           only one run of Useact. Note that MYLOGS is only an example name,
  502.           it can be any name you choose.
  503.  
  504.                                         ____________________
  505.  
  506.                1    There is an exception  to this rule. See "DOS  PATH" at
  507.                     the end of this section.
  508.  
  509.      UDBS Version 5.4                                                Page 9
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.      OUTPUT=fname
  517.  
  518.           The OUTPUT= parameter is optional. If supplied a detailed report
  519.           about the current Useact run will be generated. Typical usage:
  520.  
  521.              OUTPUT=OCT86.DAT
  522.              OUTPUT=CALLS
  523.              OUTPUT=D:\LOG\JAN1-86
  524.  
  525.           If an OUTPUT= statement is not placed into UDBS.CFG then NO
  526.           output log file will be generated.
  527.  
  528.      UPDATE=YES
  529.  
  530.           You can run USEACT.EXE with or without the database update
  531.           active. The only way to process a log into the database is by
  532.           setting this parameter to "YES" (The default is no database
  533.           generation). If any other value is used or the line is not
  534.           present in the configuration file, no update will occur. This is
  535.           useful for when you want to regenerate a log report that has
  536.           already been processed into the database.
  537.  
  538.           When update is set to "YES", thirteen (13) other files are used.
  539.           These are the actual database files. They are automatically
  540.           created the first time that update is used. These files are:
  541.  
  542.             DATABASE.DAT     This file contains individual user records. 
  543.  
  544.             MASTER.DAT       This file contains period totals. A period
  545.                              total is the cumulative amounts of each system
  546.                              function for a given update run. This is the
  547.                              same as the cumulative total screen shown at
  548.                              the end of a Useact run.
  549.  
  550.             DOWNLOAD.NAM     This file contains all the names of downloaded
  551.                              files
  552.  
  553.             DOWNLOAD.XRF     This file contains the cross reference links
  554.                              to tie a file name to a user.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.      UDBS Version 5.4                                               Page 10
  569.  
  570.  
  571.  
  572.  
  573.  
  574.             UPLOAD.NAM       Same as DOWNLOAD.NAM
  575.  
  576.             UPLOAD.XRF       Same as DOWNLOAD.XRF 
  577.  
  578.             COMMENTS.DAT     This file contains the comments you add.
  579.  
  580.             filename.HDR
  581.             filename.IDX     These are index files. There will be three
  582.                              different "filenames" corresponding to the
  583.                              files that are indexed.
  584.  
  585.           In addition, when you run an update, if the above files already
  586.           exist they are copied to backup files before processing starts
  587.           (See xBACKUP= parameters below). If an error occurs after one of
  588.           the primary files has been modified, Useact attempts to restore
  589.           the original files from the backup files. In any case, the backup
  590.           files are not deleted, and remain intact until Useact is
  591.           restarted with update set to yes, or a Purify operation is done
  592.           in Query. The backup filenames that are used are: DATABASE.BAK,
  593.           DOWNLOAD.BAK, UPLOAD.BAK, MASTER.BAK, DOWNLOAD.XBK, UPLOAD.XBK,
  594.           COMMENTS.BAK, *.HBK, & *.IBX. These files may be deleted at any
  595.           time if you need the space, if not I would leave them alone, as
  596.           they offer some sort of insurance should a problem occur. In any
  597.           event, make sure you keep you data files BACKED UP AT ALL TIMES!
  598.           These files are opened as "Access Read Write Lock Read Write". In
  599.           a network environment this prevents the doors from accessing the
  600.           files while Useact or Modify are using them. 
  601.  
  602.           If you have update set to "yes" and you run a call log that has
  603.           already been processed into the database, you will receive a
  604.           warning message and prompt warning you of the consequences.
  605.           Follow on screen prompting if you receive this condition. Users
  606.           of Multi-Node systems will not be able to use this built in
  607.           protection if they plan to process the logs from other nodes into
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.      UDBS Version 5.4                                               Page 11
  628.  
  629.  
  630.  
  631.  
  632.  
  633.           one database. This is because the same period exists in two or
  634.           more logs. Please see the description of the 'Overlapcheck=NO'
  635.           parameter, explained below.
  636.  
  637.      USEACTBACKUP=NO
  638.      PURIFYBACKUP=NO
  639.  
  640.           At the request of several users, who have extremely large
  641.           databases, I have included a way to inhibit the automatic copy of
  642.           the database files. The USEACTBACKUP=NO parameter inhibits backup
  643.           before Useact starts, and the PURIFYBACKUP=NO parameter inhibits
  644.           backup before Purify begins. Unless you keep a very concise
  645.           backup schedule and have the ability to go back to an earlier
  646.           copy if any problems are found (which these users do), I don't
  647.           recommend using either of these two parameters.
  648.  
  649.      FILES=pathname
  650.  
  651.           This parameter allows you to specify a path to the database
  652.           files. This allows you to keep the programs in one directory and
  653.           your database files in a completely separate directory. If this
  654.           line is not in the file then the database files will be looked
  655.           for in the current directory. Be sure to end your path specifi-
  656.           cation with a '\' (as in "Files=\DATA\") or an error will result.
  657.  
  658.      NEW=YES
  659.  
  660.           This parameter causes the report file generated by Useact to
  661.           contain an activity listing for new users ONLY. A new user is
  662.           determined from the log by the following two log entries:
  663.  
  664.              Refused to register
  665.              Registration information saved
  666.  
  667.           These log entries are determined by how a first time caller
  668.           responds to the question "Do you want to register?" after his/her
  669.           name was not found in the USERS file. A count is kept of registe-
  670.           red and unregistered users, and the users report entry shows
  671.           which state he/she is in. This parameter ONLY controls what is
  672.           written to the report file. If "new" is used in conjunction with
  673.           "update", ALL user activity is written to the database, but only
  674.           new users are written to the report. This was primarily intended
  675.           to be used without update to isolate all new users within a log
  676.           period.
  677.  
  678.      USERS=\Path\usersfilename
  679.  
  680.           This parameter is used to point to the subdirectory where your
  681.           PCBoard USERS file resides, and allows you to specify its name. 
  682.           Supply the full path to your users file, and INCLUDE the name of
  683.           your users file. In QUERY.EXE this is used for the "Delete if not
  684.  
  685.  
  686.      UDBS Version 5.4                                               Page 12
  687.  
  688.  
  689.  
  690.  
  691.  
  692.           in users file" function. In USEACT.EXE this is used to screen new
  693.           users from being added to the database (see NEWADDITIONS=).
  694.  
  695.              Example: Users=\PCB\MAIN\USERS
  696.  
  697.           It is important to note that Clark Development may change the
  698.           format of this file at any time when they release a new version.
  699.           If this file changes, it will render the functions requiring the
  700.           users file inoperative. You should make it a point when you
  701.           receive a new version of PCBoard to check the chapter of the
  702.           documentation where the formats of PCBoard files are shown. If
  703.           the length given for the Users file has changed, then don't use
  704.           any functions requiring the Users file until you can obtain a
  705.           update of this system. I will try to stay on top of this situa-
  706.           tion and have any necessary corrections ready at the time of a
  707.           PCBoard update. The reason I mention this is so that you are
  708.           aware this condition. It would probably be a true statement to
  709.           say that as long as any PCBoard update does not require you to
  710.           run any type of 'conversion' program on your current Users file
  711.           that its format has not changed. To allow network operation, the
  712.           users file is opened as "Access Read Shared".
  713.  
  714.           If the current version setting is 12 or greater, then the PCBNDX
  715.           index files are used to locate user names (See PCBNDX=). Indexing
  716.           is cancelled automatically if a corrupted index file is detected.
  717.           If this occurs the program stops using the index files and scans
  718.           the users file only in the same manner as the previous versions.
  719.  
  720.      PCBNDX=\path\to\pcbndx\files\
  721.  
  722.           This parameter is used to point the code to the location of your
  723.           PCBNDX.x user file index files. Starting with version 14 of
  724.           PCBoard, the location of these files is setable by the Sysop, and
  725.           do not necessarily need to reside in the same subdirectory as
  726.           your USERS file. This parameter allows you to exercise that
  727.           ability. Please note that this parameter MUST be set if you have
  728.           the USERS= parameter pointing to your users file otherwise your
  729.           index files can not be located. An error will be issued if not
  730.           properly set.
  731.  
  732.      NEWADDITIONS=NO
  733.  
  734.           As new users call your system, they are automatically added to
  735.           the database. For an open board there is no problem with this.
  736.           However, take the situation where a Sysop runs a 'closed' board.
  737.           In this situation new users cannot gain access to the system in
  738.           any meaningful way until the Sysop adds a record to the Users
  739.           file containing their information. What happens now is that
  740.           whenever a new users calls, even though he or she cannot gain
  741.           access to the system, the callers log still shows their call.
  742.           They get added to the database, and after a while the database
  743.           becomes full of names of people who aren't really users. To
  744.  
  745.      UDBS Version 5.4                                               Page 13
  746.  
  747.  
  748.  
  749.  
  750.  
  751.           prevent this from happening, include the line 'NEWADDITIONS=NO'
  752.           in the configuration file. When Useact processes user names, it
  753.           will first verify that they exist in your Users file. If they do
  754.           not, no database action will occur for that name. There is no
  755.           problem in having this set to 'no' at all times with any board.
  756.           This is because with an 'open' board all new users will be added
  757.           except those who don't register. You cannot use this option if
  758.           you are running version 10 of PCBoard, see the note under the
  759.           Version=10 parameter.
  760.  
  761.      MBQ=n
  762.  
  763.           If you require users to fill out a script questionnaire when they
  764.           log on for the first time, this function will record the date
  765.           that they do it. This date will be shown when you view the users
  766.           data record in Query. The value of 'n' should be the number of
  767.           the script questionnaire you wish to record. See page 20 for more
  768.           information on this.
  769.  
  770.      BULLETINx=y
  771.  
  772.           If you have bulletins which you require new users to read, this
  773.           is a way to monitor that. You can selectively monitor up to five
  774.           (5) of the bulletins on your system. In the parameter line you
  775.           will notice an 'x' and a 'y'. The 'x' is a number from 1 to 5
  776.           (for the five different bulletins to monitor), the 'y' is the
  777.           actual bulletin number on your system you wish to monitor. This
  778.           value can be from 1 to 99. Lets say you want to monitor bulletins
  779.           1, 3, & 4. You UDBS.CFG file would contain the following 3 lines:
  780.  
  781.              Bulletin1=1
  782.              Bulletin2=3
  783.              Bulletin3=4
  784.  
  785.           In DATABASE.DAT there are 5 different locations in the file, this
  786.           is what the value of 'x' refers to. Each location is stored as a
  787.           0 or 1 (NO or YES). Once a users bulletin location is set to a 1
  788.           (Yes), it stays that way. What this means is that once you commit
  789.           a bulletin location to a specific bulletin number (Lets say you
  790.           have Bulletin1=5), you can not change it to monitor a different
  791.           bulletin (say 6). No harm will occur, but incorrect information
  792.           will be in file. All of the locations that were set to 'yes' when
  793.           you were monitoring bulletin 5 are still set. Running a report at
  794.           this time would show someone had read bulletin 6 when in fact
  795.           they really didn't. The only way to switch to another bulletin
  796.           number is to first reset the bulletin flag you wish to reuse to a
  797.           'No' state. See the file maintenance function "Reset Bulletin
  798.           Flag" for more information.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.      UDBS Version 5.4                                               Page 14
  805.  
  806.  
  807.  
  808.  
  809.  
  810.      VERSION=
  811.  
  812.           This parameter tells the UDBS programs which version of PCBoard
  813.           files you are currently working with. It adjusts the programs to
  814.           use the proper USERS file record length and to use correct
  815.           callers log format. Setting this parameter incorrectly will cause
  816.           all sorts of failures. This is probably the most confusing of the
  817.           configuration settings since support for all PCBoard versions
  818.           from 10+ has been included. The proper settings are:
  819.  
  820.              VERSION=10
  821.  
  822.           This sets the analyzer to expect callers logs in the format that
  823.           was used with version 10. You cannot perform any user file func-
  824.           tions while Version=10. Support was not included in UDBS for
  825.           version 10 users files.
  826.  
  827.              For Version 11
  828.  
  829.           If you are running with version 11 (or processing old version 11
  830.           log files) you MUST remove this line from the configuration file.
  831.           As with version 10, NO Users file support is available for
  832.           version 11.
  833.  
  834.              VERSION=12
  835.  
  836.           This sets all programs to use the new USERS file record length of
  837.           256 bytes per record. It also adjusts Useact.Exe to read the
  838.           version 12 callers log format.
  839.  
  840.              VERSION=14
  841.  
  842.           This sets all programs to expect version 14 files formats.
  843.  
  844.  
  845.           Important: You can NOT mix version 10, 11, 12, or 14 callers log
  846.                      files into a single file. If for example you are
  847.                      running version 14 and wish to process a version 11
  848.                      log, you MUST NOT reference the USERS file. With the
  849.                      VERSION= line removed, the program attempts to access
  850.                      the USERS file with a record length on 152 bytes
  851.                      (which would cause odd results since the v14 Users
  852.                      file record length is 400 bytes). In other words, when
  853.                      processing logs from a different version than the one
  854.                      you currently use, remove the USERS= configuration
  855.                      line to stop users file access.
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.      UDBS Version 5.4                                               Page 15
  864.  
  865.  
  866.  
  867.  
  868.  
  869.      SINGLENODE
  870.  
  871.           Used in conjunction with VERSION=12 and VERSION=14. This signals
  872.           Useact.Exe that the log it is reading was generated by a single
  873.           node system. By single node I mean the /S and /D versions of
  874.           PCBoard. You will know if you have left this option out of your
  875.           config file if the first three letters of every users name are
  876.           missing.
  877.  
  878.           It has recently come to my attention that the /En versions of
  879.           PCBoard can also generate a "Singlenode" type of log if they are
  880.           told that they are not running on a network. So the above
  881.           statement may not be true in all cases. If in doubt check your
  882.           log to see if the node number is included on the first line of
  883.           each callers record (Refer to the examples below). If the node
  884.           number is missing, this is a "Singlenode" type of log and you
  885.           will need this parameter.
  886.  
  887.           Examples:
  888.                                  Node Number
  889.           Multi-node Log      
  890.           03-04-89 (14:30) (1) JEFF SUMBERG (2400) (N) RINGWOOD, NJ     
  891.  
  892.           Single node Log
  893.           04-04-89 (10:52)  JEFF SUMBERG (2400) (N) MOONACHIE, NJ       
  894.  
  895.      OVERLAPCHECK=NO
  896.  
  897.           This parameter is to be used where callers logs from Multi-Node
  898.           systems are to be processed into a single database. The overlap
  899.           checking in Useact was originally added to prevent a Sysop from
  900.           accidentally updating a database with a callers log that was
  901.           ALREADY processed. Doing so would cause incorrect information to
  902.           be placed into the database. You MUST however disable this check-
  903.           ing if you plan to keep a single database for all the nodes since
  904.           each of the logs cover the same physical time and date. BE
  905.           CAREFUL not to duplicate data as mentioned above.
  906.  
  907.      LOG=\Path\Filename
  908.  
  909.           This parameter enables Useact's logging capability. When
  910.           specified, Useact will add lines to the end of the file you
  911.           specify. This file can be the callers log (the recommended output
  912.           file), or a file devoted specifically to watching Useact's
  913.           operation. The entries written to this log are 64 characters in
  914.           length, as is required if the callers log is the specified output
  915.           file. A sample of my callers log showing the log entries is
  916.           included below:
  917.  
  918.  
  919.  
  920.  
  921.  
  922.      UDBS Version 5.4                                               Page 16
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                 Minutes Used: 5                                          
  930.           11-27-88 (11:17)  ANY CALLER Off Abnormally                      
  931.           ************************************************************** 
  932.                 Scheduled Event ran at 15:47                             
  933.           ************************************************************** 
  934.                 USEACT v 5.32b: Started at 04:32:10 on 03-17-1991        
  935.                 Processing log file: EXTRACT.2                           
  936.                 Processed 18 calls from 12 users.                        
  937.                 There were 8 D/L's, and 2 U/L's during this period.      
  938.                 Processing completed normally at 04:32:59                
  939.           ************************************************************** 
  940.           11-27-88 (16:12)  NEXT CALLER (2400) (N) MOONACHIE, NJ           
  941.  
  942.           If Useact encounters any errors that cause it to end abnormally,
  943.           they will be reported in the log.
  944.  
  945.      EVENT
  946.  
  947.           This parameter tells Useact that you are running it in unattended
  948.           batch mode (such as Event.Sys). If an 'illegal function' error
  949.           should occur from a bad or unrecognized line, Useact will
  950.           automatically skip the line (writing it to the log if specified)
  951.           and continue, rather than displaying the prompt to continue or
  952.           terminate. This way if an error does occur, your system will not
  953.           be 'hung up' waiting for you to answer the prompt at 3am!. (see
  954.           Running Useact as an event).
  955.  
  956.      REPORT=
  957.  
  958.           This parameter instructs Useact to write the cumulative report
  959.           screen to a file. This file can be used as a bulletin if you
  960.           wish. If you have ever seen the cumulative report screen at the
  961.           end of Useact, this is a duplicate of that screen in a file.
  962.  
  963.      COLOR=NO
  964.  
  965.           If you are using a color system, and you prefer the Black & White
  966.           appearance of previous versions, this will force the programs to
  967.           stay in B/W mode.
  968.  
  969.      DOS PATH
  970.  
  971.           As stated earlier, the configuration file UDBS.CFG is expected to
  972.           be in the current directory when the programs are run. The only
  973.           exception to this rule is with the Query program (Query.Exe and
  974.           indirectly Modify.Exe). Query may be run from any directory on
  975.           your system as long as the configuration file can be found in
  976.           your Path statement. When query is first run, it first checks the
  977.           current directory to see if the configuration file is there. If
  978.           not, it then checks every directory in your path in an attempt to
  979.           locate it. If it is found, program operation continues as ex-
  980.  
  981.      UDBS Version 5.4                                               Page 17
  982.  
  983.  
  984.  
  985.  
  986.  
  987.           pected. If it cannot be located an error message is issued. As an
  988.           example, say you keep all UDBS related programs in a subdirectory
  989.           called UDBS. Your Path statement might look like this:
  990.  
  991.              PATH=C:\;D:\EDIT;C:\UDBS;C:\PCB;D:\UTILITY ....
  992.  
  993.           If you were to shell out from PCBoard to check on a user, you
  994.           would be in the \PCB directory. It would no longer be necessary
  995.           to switch to the \UDBS directory to run the Query program. First
  996.           the path would direct DOS to the executable files. Then the Query
  997.           program would locate the configuration file when it searched the
  998.           path.
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.      UDBS Version 5.4                                               Page 18
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                          Text and Language Configuration
  1047.  
  1048.      Beginning with release 14 of PCBoard, the sysop has been given the
  1049.      ability to customize their system PCBTEXT file with a program called
  1050.      MKPCBTXT. In the process of making a system more friendly it also
  1051.      called a problem because the standard text entries written to the
  1052.      callers log changed as well, causing loss of text matches and improper
  1053.      counts. Another problem was mixed language systems. Every time a
  1054.      language is changed, that section of the callers log is written in
  1055.      another language. Since this program was written for english callers
  1056.      logs, it was as if these sections didn't even exist. 
  1057.  
  1058.      Useact has the ability to be configured by the sysop to recognize
  1059.      custom changes to the callers log AND callers logs in multiple mixed
  1060.      languages. When Useact begins it reads in one or more text files
  1061.      containing the match strings for the particular language(s) you are
  1062.      using. Then when a line of text is analyzed, it is checked for a match
  1063.      in each respective language. Each language file contains 31 lines of
  1064.      standard unformatted ASCII text, and is created with a text editor. A
  1065.      standard English file is included containing all the standard PCBTEXT
  1066.      entries Useact searches for.
  1067.  
  1068.      The following parameters control language configuration:
  1069.  
  1070.      Languages=n
  1071.  
  1072.           This parameter tells Useact the number of languages that will be
  1073.           used. It controls the number of language files to read, and the
  1074.           number of comparisons to check each line against. This parameter
  1075.           must be specified, and must be at least one (1).
  1076.  
  1077.      LanguageX=\path\Language_Filename
  1078.  
  1079.           Depending on the number of languages you specified in the
  1080.           previous parameter, you will have one or more of these
  1081.           parameters. The 'X' specifies the number of the language file.
  1082.           The parameter specified is the name of the file containing the
  1083.           language text. The text most often used in the log should be the
  1084.           first file specified (Language1=). The second most used would be
  1085.           number two (Language2=), and so on. If this format is not
  1086.           followed, the program will work correctly, but text scanning will
  1087.           take longer than necessary. A typical 3 language configuration
  1088.           might look like this:
  1089.  
  1090.           Languages=3
  1091.           Language1=English.Udb
  1092.           Language2=French.Udb
  1093.           Language3=Spanish.Udb
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.      UDBS Version 5.4                                               Page 19
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                               Language File Format
  1106.  
  1107.      References will be made to the text file ENGLISH.UDB. Please refer to
  1108.      that file during this section. 
  1109.  
  1110.      This language text file(s) contain 31 lines. The order of the lines is
  1111.      fixed, by this I mean that "Operator Paged" (or its equivalent) MUST
  1112.      be the sixth line in every file. The character (~) is used as a
  1113.      comment marker. This character is used as a substitution character by
  1114.      PCBoard to tack additional text onto the line. When (~) is read by
  1115.      Useact all text from that point to the end of the line is stripped
  1116.      off. Any spaces preceding the (~) are also stripped off. Most of the
  1117.      lines in this file will work with all versions of PCBoard callers
  1118.      logs, except where indicated. Some text scans from early versions of
  1119.      PCBoard (10 & 11) are still hard coded into Useact. You may have to
  1120.      change some lines in this file to process version 12 logs properly.
  1121.      The numbers indicated inside the parenthesis is the record number from
  1122.      PCBTEXT that this line corresponds to (The numbers are from version
  1123.      14.x PCBTEXT).
  1124.  
  1125.      Several lines must be modified by you in order to be properly matched,
  1126.      or follow a specified format to work correctly. These lines have
  1127.      already been modified in the supplied english text file, but you
  1128.      should make special note of them:
  1129.  
  1130.      Message Left: Main Board
  1131.  
  1132.           This line exists in PCBTEXT as "Message Left:~". If you wish to
  1133.           count ALL messages left to ANY conference, you can leave the line
  1134.           like this. If you wish to count Main Board messages only (which
  1135.           is what this program only did in prior versions), you must add
  1136.           "Main Board" to the line (as shown). You can add whatever
  1137.           conference you wish. Just follow the format as written to the
  1138.           log.
  1139.  
  1140.      Comment Left: Main Board
  1141.  
  1142.           Same as above
  1143.  
  1144.      Bulletin Left: Main Board
  1145.  
  1146.           Same as above. Decide which bulletins read are the ones you want
  1147.           checked. You MUST include the conference name up until (but not
  1148.           including) the # sign or this scan will fail. "Main Board" has
  1149.           already been added since this is what has always been scanned for
  1150.           in prior versions.
  1151.  
  1152.      Main Board Questionnaire (n) Info. Saved
  1153.  
  1154.           PCBTEXT contains the line "Questionnaire ( ) Info. Saved".
  1155.           PCBoard then adds the number, and the conference where the
  1156.           questionnaire was answered. You must supply the finished line in
  1157.  
  1158.      UDBS Version 5.4                                               Page 20
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.           the text file. You can scan for any number, and any conference,
  1165.           since you're supplying the line to scan for. This shows up as the
  1166.           MBQ date on the Query screen.
  1167.  
  1168.      Minutes Used:
  1169.  
  1170.           The colon (:) is required on the text line. It is used for
  1171.           positioning to find the actual time. If you change the line, it
  1172.           must end in a colon. "You have been on for:" is legal since it
  1173.           ends in a colon.
  1174.  
  1175.      ZIP view executed on file
  1176.  
  1177.           Notice I have left the "ZIP" (or "ARC", "PAK") off this line in
  1178.           the supplied file. This makes it catch all compressed view
  1179.           commands regardless of the method you use.
  1180.  
  1181.      Most lines (except the ones noted above) can be used as they exist in
  1182.      PCBTEXT. Be sure if you make any changes to PCBTEXT that you copy all
  1183.      your custom changes to the UDBS language file(s). 
  1184.  
  1185.  
  1186.                                Text Matching Rules
  1187.  
  1188.      Each line in the language text file is associated with one of the
  1189.      count fields you see in the Query program. Placing the wrong text on
  1190.      the wrong line will cause the wrong field to increment. You must
  1191.      follow the order shown in the English.Udb file. Every line in the
  1192.      callers log file is checked for a match against every entry the
  1193.      language file(s).
  1194.      You can use as little, or as much text in the scan lines as you wish,
  1195.      as long as what you use is unique from some other log entry. For
  1196.      example:
  1197.  
  1198.           In the language file, the line "Access Denied - Real Names Only
  1199.           Allowed!" will cause a match and increment the trashcan field.
  1200.           However placing "Real Names Only" in the language file will cause
  1201.           the same to occur since it matches part of the log entry.
  1202.  
  1203.           But, if you used "DOOR" instead of "OPENED DOOR" in the language
  1204.           file, you would match on other log entries besides "opened door"
  1205.           (all lines containing the word "DOOR"). This is incorrect and not
  1206.           what you want to do.
  1207.  
  1208.      This method gives the Sysop full flexibility for text matching. With a
  1209.      little caution in setup, anything should be detectable.
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.      UDBS Version 5.4                                               Page 21
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.      The list that follows shows which configuration parameters are used by
  1224.      each program:
  1225.  
  1226.      Useact:
  1227.  
  1228.              Input=          Output=         Files=          New=
  1229.              Update=         Overlapcheck=   BulletinX=      Report=
  1230.              Newadditions=   Users=          Version=        Event
  1231.              UseactBackup=   PCBndx=         Languages=      LanguageX=
  1232.  
  1233.      Query/Modify:
  1234.  
  1235.              Files=          Users=          BulletinX=      Version=
  1236.              PCBndx=         PurifyBackup=   Color=
  1237.           
  1238.      Sync:
  1239.  
  1240.              Files=          Users=          Version=        PCBndx=
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.      UDBS Version 5.4                                               Page 22
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                            Program Operation - Useact
  1283.  
  1284.      Useact essentially runs without operator intervention. Once started,
  1285.      it runs until completion (or an error is detected). During operation
  1286.      several information displays are constantly updated. These are all
  1287.      self explanatory, with perhaps the exception of "Storage Available".
  1288.      This is the amount of free string space that Useact places user names,
  1289.      File names, message numbers, etc. into. If your callers log is larger
  1290.      than Useact can process in one cycle, it will automatically go to the
  1291.      database update phase (if enabled) and generate a report to the output
  1292.      file named in the Output= parameter (if enabled). Useact will then
  1293.      continue with the callers log at the point where it left off. This
  1294.      cycle will be repeated as many times as necessary to complete the log.
  1295.      When Useact processes the log in sections, subsequent reports (if
  1296.      enabled) are output as CONTINUE.n, where n is the section number. As
  1297.      an example, if it takes Useact three cycles to complete a large log
  1298.      file and the Output= parameter specified a filename of 'log' then you
  1299.      would have the following report files: Log, Continue.1, and Contin-
  1300.      ue.2. If Useact finishes the log in one cycle, a cumulative total of
  1301.      all monitored system activity is displayed on your screen (The period
  1302.      total). This information is not displayed if multiple cycles are
  1303.      required to process a log. In any event, this information is always
  1304.      written at the beginning of the report(s).
  1305.  
  1306.                            Running Useact In Event.Sys
  1307.  
  1308.      Only the calls from the past 24 hours can be run through Useact
  1309.      otherwise a duplication of information will occur. Appendix B (The
  1310.      Newcalls Utility) and Appendix C (Setup for Multi-Node Systems)
  1311.      explain how to properly set up your event operations. The Newcalls
  1312.      program is a provided utility that marks the last place in the callers
  1313.      log where the previous event occurred, and extracts to a separate file
  1314.      all calls since then. Useact then processes the entries in this
  1315.      extract file. This way only the log entries since your last event are
  1316.      processed (be it daily, twice a day, or even weekly).
  1317.  
  1318.                             Error Handling In Useact
  1319.  
  1320.      If an error is encountered during processing in Useact, a diagnostic
  1321.      message will appear at the bottom of the screen. This message will
  1322.      give you information about the actual error and any remedial steps you
  1323.      can take to correct it. One error in particular is 'Illegal Function
  1324.      Call'. This can occur from several types of errors within the callers
  1325.      log that can be caused by PCBoard itself (Such as the system freezing
  1326.      and not correcting the log). If this occurs, the line containing the
  1327.      error will be displayed and you will be given the option of ignoring
  1328.      it and continuing or terminating processing so that you can edit this
  1329.      in the log. The choice is yours. (This is disabled if EVENT is
  1330.      active).
  1331.  
  1332.  
  1333.  
  1334.  
  1335.      UDBS Version 5.4                                               Page 23
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.                            Useact's Command line mode
  1343.  
  1344.      When I was writing Useact.Exe I added the ability to enter configura-
  1345.      tion parameters on the command line when the program was started. This
  1346.      way I didn't have to change the UDBS.CFG file each time to test some-
  1347.      thing. I have left this in the final program since it does offer some
  1348.      flexibility in operation. Useact will accept any of the configuration
  1349.      parameters it normally uses, with the following rules:
  1350.  
  1351.              1) The UDBS.CFG file still must exist
  1352.  
  1353.              2) The Config file is read first, then the command line
  1354.                 parameters.
  1355.  
  1356.              3) The command line parameters then supersede any parameters
  1357.                 found in the Config file.
  1358.  
  1359.              4) If the parameter doesn't exist in the Config file then
  1360.                 it is set from the command line
  1361.  
  1362.      As a quick example, assume your UDBS.CFG file had the following lines:
  1363.  
  1364.              Input=\Main\Caller
  1365.              Output=\Reports\Log
  1366.              Update=Yes
  1367.  
  1368.      Assume you wish to generate a report from an older callers log that is
  1369.      on a floppy disk. Normally you would have to edit UDBS.CFG to use the
  1370.      floppy drive, and turn off the updates. All you do is this from the
  1371.      command line:
  1372.  
  1373.      C>USEACT Input=A:filename Update=No
  1374.  
  1375.      As you can see, update, which is first read as 'Yes' will be changed
  1376.      to 'No'. Input, which was '\Main\Caller' will become 'A:Filename'.
  1377.      Parameters must be specified exactly the same way they are in the
  1378.      Config, I.E. no space before or after the equal sign. You must however
  1379.      separate each parameter with at least one space.
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.      UDBS Version 5.4                                               Page 24
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.                             Program Operation - Query
  1401.  
  1402.      The Query program allows you view the information stored in the
  1403.      database in a variety of ways. This program is totally menu driven
  1404.      with pop-up windows to guide you through the different search modes.
  1405.  
  1406.      A selection may be activated in one of two ways. Note the key letter
  1407.      at the beginning of each line and simply press that letter on your
  1408.      keyboard, the selection will execute immediately, or you can select
  1409.      using the cursor keys, and press Return when the selection bar is over
  1410.      the item you want.
  1411.  
  1412.      With selections that require you to enter a user or file name, it is
  1413.      not necessary to type the entire name, you can just type the first few
  1414.      characters of the name. Names are stored in the index file and if an
  1415.      exact match is not found, a list of close matches (up to twenty) will
  1416.      be presented in a window. You can then choose the one you want from
  1417.      this list. If what you want is not displayed in the list you can hit
  1418.      the ESC key to abort the search. This is very helpful if you are
  1419.      unsure of the complete name or the spelling. You will find this
  1420.      feature extremely useful, convenient, and timesaving.
  1421.  
  1422.      Names are sorted into alphabetical order in the index files from left
  1423.      to right. Therefor, partial searches always start at character
  1424.      position one. You can't for example enter a partial last name and get
  1425.      a close match on that. Partial searches always go from left to right.
  1426.  
  1427.      User Statistics
  1428.  
  1429.           This brings up a users activity record. When you select this, a
  1430.           window appears asking for the users name. If you decide at this
  1431.           point that you do not want to view a record, press Return and you
  1432.           will be returned to the main menu screen.
  1433.  
  1434.           If the name you entered was found, the users record appears on
  1435.           the screen with all system activity shown. If the users name was
  1436.           not found or you entered a partial name, a list of close matches
  1437.           will be presented in a window. Also shown is the date when this
  1438.           record was last updated by Useact, the date of this users first
  1439.           call to the system (if known), and the date the user answered the
  1440.           main board questionnaire (MBQ). Press F1 to view files downloaded
  1441.           by this user, F2 to see uploaded files, or hit Return for the
  1442.           main menu screen.
  1443.  
  1444.      Users Who Never Download
  1445.      Users Who Never Upload
  1446.  
  1447.           Use this function to isolate users with no file activity. When
  1448.           selected you will first be prompted to enter a "times on the
  1449.           system" value. This is used to isolate even further the inactiv-
  1450.           ity of users. Example, perhaps 100 people never upload after
  1451.  
  1452.  
  1453.      UDBS Version 5.4                                               Page 25
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.           1 time on the system, but if you entered 75, then only users who
  1460.           didn't upload after being on for 75 calls would be shown.
  1461.  
  1462.           In addition, when selecting users who never upload, you will also
  1463.           be asked if you want to see the ones who download, but never
  1464.           upload (There is a difference). The list will show the download
  1465.           count along side the user name.
  1466.  
  1467.      File Transfers During a Specific Period
  1468.  
  1469.           Use this function to find the names of files transferred between
  1470.           a starting and ending date. When you choose this function, a
  1471.           window will appear asking you if you would like to see downloads
  1472.           or uploads. Another window will then appear asking you to choose
  1473.           a date period. You may enter specific start and end dates or
  1474.           choose a date period from the period totals list. The prompts
  1475.           after this choice are self explanatory. Depending on the date,
  1476.           range, and size of your files, this function might take a minute
  1477.           or two so don't get impatient.
  1478.  
  1479.      Users With Keyboard Timeout Disconnects
  1480.  
  1481.           They sign in, and walk away. they start a download, and don't
  1482.           come back. You know the type. They show up here.
  1483.  
  1484.      Users Disconnected For Daily Time Limit
  1485.  
  1486.           These are people who use every second you give them. You can use
  1487.           this to find the time hogs, or perhaps a good user who needs more
  1488.           time.
  1489.  
  1490.      Users That Downloaded A Specific File
  1491.      Who Uploaded A Specific File
  1492.  
  1493.           A window will appear asking for a filename. You may enter a
  1494.           partial filename (in which case the close match window will
  1495.           appear) or the entire filename if known. The User(s) that
  1496.           downloaded or uploaded this file and the date of the transfer are
  1497.           shown.
  1498.  
  1499.           Press F1 to view a user record, a Window will appear asking for a
  1500.           name. Enter a user name (or hit Return to go back to the main
  1501.           menu). The users record will be displayed, and the function keys
  1502.           associated with that selection become active.
  1503.  
  1504.      All Files Downloaded By A Specific User
  1505.      All Files Uploaded By A Specific User
  1506.  
  1507.           A Window will appear asking for a user name. You may enter a
  1508.           partial name (in which case the close match window will appear)
  1509.           or the entire name if known. All files associated to this user
  1510.           are listed, along with the transfer date.
  1511.  
  1512.      UDBS Version 5.4                                               Page 26
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.           Press F1 to open this users record.
  1520.           Press F2 to view the opposite transfer direction.
  1521.  
  1522.      Display Period Totals
  1523.  
  1524.           Use this function to display the total amount of system usage
  1525.           from each update period. The display will show you the periods on
  1526.           file. The periods show in reverse order starting from the latest,
  1527.           and decreasing to the earliest.
  1528.  
  1529.           Press F1 to view a specific period, a window appears asking for a
  1530.           period number. Enter desired value. The display now shows the
  1531.           totals for that period.
  1532.  
  1533.           Press F2 to totalize a group of periods. A window appears asking
  1534.           for starting and ending periods. The display shows the total
  1535.           amount of activity during this group of periods. To display total
  1536.           system usage stored, enter "one" (1) for the starting period, and
  1537.           "zero" (0) for the ending period. All period totals will be
  1538.           summed and displayed.
  1539.  
  1540.      Users Exceeding DL/UL Ratio
  1541.  
  1542.           When selected, you will be asked for a ratio (xx:1). Enter the
  1543.           ratio you desire, or press Return to abort search. All users
  1544.           whose ratios are equal or greater will be displayed. The amount
  1545.           of downloads and uploads are shown, as well as the actual ratio
  1546.           (Rounded to the nearest count).
  1547.  
  1548.      Users That Never Left A Message
  1549.  
  1550.           These are users that never left a main board message. I suppose
  1551.           you could assume that these users have never read one also, but
  1552.           the log doesn't show this. A count of the times on the system is
  1553.           also shown to give you some idea of how active this user is on
  1554.           your system.
  1555.  
  1556.           Press F1 to open a user record. As before, enter a name, or just
  1557.           press enter.
  1558.  
  1559.           F2 and Return have different meanings depending on the size of
  1560.           the listing. Follow on screen prompts.
  1561.  
  1562.      Doors and Node Chat
  1563.  
  1564.           This function is used to help give you some idea of the activity
  1565.           for these two commands. A window will appear asking for the Doors
  1566.           mode or the Node Chat mode, after you make your selection,
  1567.           another window appears with a sub menu asking for your choice
  1568.           (Has used/Has not used). Users falling under the category are
  1569.  
  1570.  
  1571.      UDBS Version 5.4                                               Page 27
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.           shown, along with their number of times on the system. Follow on
  1578.           screen prompts for the proper use of the function keys
  1579.  
  1580.      Users With Security Violations
  1581.  
  1582.           Since there is more than one type of security violation, a window
  1583.           will appear with a sub menu when this function is selected. On
  1584.           each security display a count of the number of times the
  1585.           violation occurred is displayed next to the name.
  1586.  
  1587.                Selection Not Available
  1588.  
  1589.                      List all users that have selected a command that is
  1590.                      not allowed under their security level.
  1591.  
  1592.                Not Registered In Conference
  1593.  
  1594.                      Attempts to Join a conference that is private.
  1595.  
  1596.                Download Violation
  1597.  
  1598.                      Attempts to download password protected files, or
  1599.                      files with minimum security level higher than this
  1600.                      user.
  1601.  
  1602.                Access Denied - Password Fail
  1603.  
  1604.                      Disconnects for failed password during sign on
  1605.  
  1606.                      Access Denied - Trashcan
  1607.  
  1608.                      Trashcan name disconnects
  1609.  
  1610.                Access Denied - Locked Out
  1611.  
  1612.                      Locked out users, who tried anyway to get back on.
  1613.  
  1614.                Access Denied - Refused to Register
  1615.  
  1616.                      Callers denied access to the system after answering
  1617.                      'no' to the question "Do you wish to register?" (If
  1618.                      the Sysop has PCBsetup configured to give a level of
  1619.                      zero to these users). This does not apply if you set
  1620.                      NEWADDITIONS=NO since callers who refuse to register
  1621.                      are never added to the database.
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.      UDBS Version 5.4                                               Page 28
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.                All Of The Above
  1637.  
  1638.                      Displays users that have any of the above conditions,
  1639.                      the quantity of the violation(s) are displayed next to
  1640.                      the name as:
  1641.  
  1642.                      C: n  P: n  R: n  T: n  L: n  S: n  D: n
  1643.  
  1644.                      C = Conference, P = Password, R = Refuse to Reg.
  1645.                      T = Trashcan, L = Locked out, S = Selection N/A
  1646.                      D = Download Violation
  1647.  
  1648.      Baud Rates and Protocols
  1649.  
  1650.           A window appears with a sub menu when you select either of these
  1651.           functions. Select the item you wish from the sub menu. The users
  1652.           name, and a count of how many times the selection was used is
  1653.           displayed. Follow on screen prompts for the use of the function
  1654.           keys.
  1655.  
  1656.      Users That Page Sysop
  1657.  
  1658.           The users name, and the number of times they paged you are shown.
  1659.           The screen shows the meaning of the function keys.
  1660.  
  1661.      Show New Users On Specified Date
  1662.  
  1663.           Use this selection to scan the database and show all new callers
  1664.           for either a whole month or a specific day. A window will appear
  1665.           with a menu asking you which function you wish to use. Use
  1666.           leading zeros on the date if necessary as each digit must occupy
  1667.           two places. (EX: 01/08/87 or 05/12/87)
  1668.  
  1669.      Scan For User Name
  1670.  
  1671.           A window appears. Enter the part of the name you are looking for.
  1672.           This function is identical in operation to the name scan function
  1673.           of Sysop board command #7. Any name containing this part is
  1674.           displayed. As little as one character may be entered. Follow on
  1675.           screen prompts for the use of the function keys. This scan does
  1676.           not use the index file, it scans for text, not for index key
  1677.           order, and you can enter any part of the name.
  1678.  
  1679.      Generate Reports
  1680.  
  1681.           This mode allows you create reports using most of the functions
  1682.           discussed above. When entering this mode, a new menu will appear
  1683.           containing report functions. When a function is selected a window
  1684.           appears asking for the name of the output file. This is where the
  1685.           report will be written to, and can be any valid Dos filenames (or
  1686.           device). If it is desired to direct output to the printer, simply
  1687.           press Enter. Its is assumed that the printer is device LPT1.
  1688.  
  1689.      UDBS Version 5.4                                               Page 29
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.                            File Maintenance Functions
  1696.  
  1697.      When you select the file maintenance functions, a second module will
  1698.      be loaded from disk (Modify.Exe). At this time, all the database files
  1699.      are locked (not PCBoard specific files, these are always shared). This
  1700.      is done to prevent other UDBS programs accessing them while you
  1701.      perform any maintenance function. If a UDBS door happens to be running
  1702.      at this time, you will not be granted access to the files and will be
  1703.      returned to the Query module. Since the door has a four minute limit,
  1704.      you can try again in a few moments. After this module is loaded and
  1705.      the files successfully locked, a window will appear with the following
  1706.      functions:
  1707.  
  1708.      Delete User
  1709.  
  1710.           A window will appear asking for a user name (Partial names are
  1711.           accepted and close matches will be shown). The users record will
  1712.           then be displayed, press Return to delete the record, or Escape
  1713.           to abort the delete operation. Once deleted, the record will no
  1714.           longer appear in any query operation (except undelete), and the
  1715.           name will be considered new if found in the callers log during a
  1716.           database update. A deleted record may be restored unless the
  1717.           files have been purified, or the name has been added again by
  1718.           another update.
  1719.  
  1720.      Delete If Not In User File
  1721.  
  1722.           This function allows you to remove users from the database if
  1723.           they don't exist in your PCBoard users file. This selection can
  1724.           be run two ways, and a window will appear with your choices. 1)
  1725.           It will stop and show you each users record before actually
  1726.           deleting it (Giving you the opportunity to skip deletions), or 2)
  1727.           Delete immediately without acknowledgement. All deleted records
  1728.           can be undeleted before the files are purified. You cannot use
  1729.           this function if you are running version 10 of PCBoard, see the
  1730.           note under the VERSION=10 parameter.
  1731.  
  1732.      Purify Files
  1733.  
  1734.           When a user record is deleted, it is really only marked as
  1735.           deleted thereby allowing it to be restored. Purify reads all the
  1736.           data files and physically removes deleted records. Before purify
  1737.           starts, it creates backup copies of the database files in the
  1738.           unlikely event a system failure occurs.
  1739.  
  1740.           Unlike the previous versions, a Purify now takes much less time
  1741.           to perform. This is due to the fact that the data files no longer
  1742.           need to be packed (a method in which a record is removed by
  1743.           shifting all records above it down by one and renumbering all
  1744.           references that were shifted). A record is now removed by marking
  1745.           it as free, in effect creating a 'hole' in the file. When a new
  1746.           record is added these holes are used first before any records are
  1747.  
  1748.      UDBS Version 5.4                                               Page 30
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.           physically added to the file. Therefore certain files will never
  1755.           get smaller after a Purify is finished but will remain the same
  1756.           size until all the empty records (holes) are filled. The only
  1757.           data files that are still packed are the files with the .XRF
  1758.           extension. This is so all file transfers stay in the proper date
  1759.           order. The amount of time required to pack both of these file has
  1760.           always been minimal, perhaps several minutes each.
  1761.  
  1762.           You can stop purify and start it again at a more convenient time
  1763.           if desired. If you wish to stop processing after purify has
  1764.           started, press the Space Bar. When the code gets to a point where
  1765.           it can break, you will be returned to the File Maintenance menu.
  1766.           PLEASE be patient as it may take a minute or so reach the end of
  1767.           a pass, so DON'T keep hitting the Space Bar. This is the only way
  1768.           to stop a purify in progress, otherwise PERMANENT file damage may
  1769.           result (If you reboot for instance).
  1770.  
  1771.           Before purifying the database, it is a good idea to check the
  1772.           undelete function to make sure that there aren't any users marked
  1773.           for deletion that you might want to keep. Once purified, deleted
  1774.           records are gone for good!
  1775.  
  1776.                                  ** IMPORTANT **
  1777.  
  1778.           Just a note to users running single node systems under a multi-
  1779.           tasking system. I have placed file locking code into the program,
  1780.           to prevent other programs (such as the doors) from accessing the
  1781.           files during purify, but this will not be active unless the SHARE
  1782.           program is loaded before your multi-tasking system is started. In
  1783.           general, if you don't use SHARE, then I strongly recommend that
  1784.           you run purify OFF-LINE (or disable the doors if you have them).
  1785.  
  1786.      Undelete User
  1787.  
  1788.           When a user record is deleted, a flag within that record is set
  1789.           to mark a deleted status. This function is used to clear this
  1790.           flag and restore a record to a normal condition. When you select
  1791.           this option, a list appears showing all deleted user names. Press
  1792.           F1 to select a name for undeletion (This name you must enter in
  1793.           its entirety, partial names are not accepted here). After you
  1794.           enter the user name, the database is checked to make sure that a
  1795.           current user by that name doesn't already exist (say you deleted
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.      UDBS Version 5.4                                               Page 31
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.           a user, and he called back). If it does exist, the undelete
  1814.           request is aborted to prevent duplicate records from being
  1815.           created, otherwise the username is restored.
  1816.  
  1817.      Add Download Credit
  1818.      Add Upload Credit
  1819.  
  1820.           Use this function to add file credits to a users record. Up to
  1821.           ten credits can be added at one time. Enter the filenames if
  1822.           known. If the filename is not known, press F1 and the name
  1823.           'Credit' will be used. The transfer date on reports will be shown
  1824.           as 'Credit' if a filename was used, and as a transfer with
  1825.           filename unknown if F1 (Credit) was used. Press Enter if no more
  1826.           names are to added. The users Up/Download counts are also
  1827.           adjusted.
  1828.  
  1829.      Delete Download Credit
  1830.      Delete Upload Credit
  1831.  
  1832.           Use this function to delete file credits from a users record.
  1833.           After the users name is entered, the screen will display the
  1834.           names of the files that the user has transferred. (The word
  1835.           'Credit' appears when the name of the transfer is not known). The
  1836.           file in the upper left corner will be highlighted. Use the cursor
  1837.           arrows keys to move the highlight. Select files for deletion by
  1838.           depressing F1. After a file has been selected, it blinks. A
  1839.           selected file may be un-selected by depressing F1 again. When all
  1840.           files you wish to delete have been selected, press F10, and those
  1841.           files will be deleted. The users Up/Download count will be
  1842.           adjusted. The transfer protocol counts will also be adjusted.
  1843.           Deleted credits cannot be undeleted, they must be reentered with
  1844.           the Add Credit function (above).
  1845.  
  1846.      Database Size Information
  1847.  
  1848.           This selection brings up a window showing you the number of used
  1849.           records (items stored) and the number of empty records (holes) in
  1850.           each file. Press any key to return to the main menu.
  1851.  
  1852.      Change User Name
  1853.  
  1854.           Use this function to change the name of a user record (for in-
  1855.           stance a handle being changed to a real name). Enter the name
  1856.           that you wish to change (partial names are accepted). The name
  1857.           will be displayed along with a prompt asking for the new name.
  1858.           The new name must be no longer than 25 characters, a gauge bar is
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.      UDBS Version 5.4                                               Page 32
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.           provided to help you judge the length. The database is then
  1873.           checked to see that the new name you have entered doesn't already
  1874.           exist. If it does, the change request aborts, otherwise the
  1875.           change is made and you are returned to the menu.
  1876.  
  1877.      Subscriptions
  1878.  
  1879.           Use this function to enter, change or check for subscription
  1880.           expirations. When selected, a window appears asking if you would
  1881.           like to check an expiration or enter/change a date. 
  1882.  
  1883.           If you choose "check" (A), you will be asked if you would like to
  1884.           use today's date as the basis for expiration. If you choose
  1885.           "yes", then all subscriptions that have or are expired are shown.
  1886.           If you answer "no" to this question, you will be asked to supply
  1887.           the number of days until expiration. Enter any value (from 1 to
  1888.           32000). All subscriptions having this many days or less are
  1889.           shown. You can use this to determine which subscriptions are
  1890.           about to expire.
  1891.  
  1892.           If you choose "Enter/Change" (B), a window will appear asking for
  1893.           a users name. After you enter the name (partial names accepted),
  1894.           the users subscription date will be shown (if one exists) and the
  1895.           number of days remaining until expiration. To enter a
  1896.           subscription date, supply the month at the prompt "Month? [C/R =
  1897.           no change or reset]" followed by the day and year. To leave the
  1898.           existing date or reset an existing subscription to "Non sub-
  1899.           scriber" status, press return at this point (you will then be
  1900.           asked if you wish to clear the date).
  1901.  
  1902.      Comments
  1903.  
  1904.           Use this function to add comments to a users record. You will be
  1905.           able to enter two comment lines to each users record if desired.
  1906.           The first comment line is visible to the user when they use the
  1907.           Query door. The second line is ONLY visible to you. When you
  1908.           select this function a window appears asking you if you would
  1909.           like to (A) enter/change/delete user comments, (B) scan for text
  1910.           in the comments file, or (C) delete all comments.
  1911.  
  1912.           If you choose (A), a window will appear asking for the users name
  1913.           (partial names are accepted). After the name is entered, one of
  1914.           two comment screen will appear. 1) If no comments have been
  1915.           entered for this user, you will get the "enter comments" screen.
  1916.           You may enter one or both comment lines at this time (you can
  1917.           enter line one, and leave line two blank, or visa-versa). If you
  1918.           do not wish to enter a comment to this user at this point, leave
  1919.           BOTH lines blank, and no comment will be added. 2) if comments
  1920.           already exist for this user you will get the "edit comments"
  1921.           screen. The current comment lines will be shown at the top of the
  1922.           screen, and the first comment line will be placed on the edit
  1923.           line. The available editing functions are listed at this time on
  1924.  
  1925.      UDBS Version 5.4                                               Page 33
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.           the screen so I won't explain them here. After you finish editing
  1932.           the first line and press enter then second comment will be placed
  1933.           on the edit line. Press enter when finished. If you wish to
  1934.           delete the comments for this user, press ESC to delete each
  1935.           comment line. If BOTH comment lines are NULL when you finish
  1936.           editing, the comment record will be deleted.
  1937.  
  1938.           If you choose (B) "Scan Comment File For Text", you will asked to
  1939.           supply the text to scan for. This is similar to the "scan for
  1940.           user name" function. The comment records containing any portion
  1941.           of the text you enter will be shown along with the user name they
  1942.           are associated with. You could for example find all your
  1943.           registered users, if for example you placed in one of the comment
  1944.           lines "registered" and then scanned for that word.
  1945.  
  1946.           If you choose (c) "Delete All Comments", you will be prompted to
  1947.           make sure this is what you really wish to do. If you answer yes,
  1948.           all comments for every user will be deleted. You cannot undo this
  1949.           operation once selected.
  1950.  
  1951.      Rebuild Index Files
  1952.  
  1953.           Over time, especially after periods of heavy additions and dele-
  1954.           tions to the index files, the keys may become "unbalanced". This
  1955.           results in a decline in access speed and can under rare
  1956.           conditions cause an improper lookup. There is no recommended
  1957.           interval I can offer to you for performing this function, however
  1958.           I would do it at least once every two months. If you begin to
  1959.           notice search times slowing down, this might help. If you purge
  1960.           users on a regular basis, and do alot of purifications, I would
  1961.           do this more often, say on a monthly basis. 
  1962.  
  1963.           This function deletes the existing index files and rebuilds the
  1964.           keys from scratch. What you may gain is a smaller index file
  1965.           since all of the deleted keys are gone. Three index files are
  1966.           rebuilt, One for the main database file, one for the download
  1967.           name file, and the last for the upload name file. As each file is
  1968.           being rebuilt, an on screen percentage indicator is constantly
  1969.           updated. You cannot stop this operation once you start it. The
  1970.           time it takes to rebuild depends on the size of your files. Make
  1971.           sure you keep accurate backups also! I cant say this enough.
  1972.  
  1973.      Reset Bulletin Flag
  1974.  
  1975.           As explained earlier, once you set a bulletin parameter (1-5) to
  1976.           monitor a particular bulletin (1-99), you can't use that
  1977.           parameter to monitor a new bulletin since many flags could
  1978.           already be set to a 'Yes' state. If you decide to change a
  1979.           bulletin slot (1-5) to monitor a different system bulletin you
  1980.           can use this function to reset each of the bulletin flags for all
  1981.           users back to a 'No' state. You can also use this function to
  1982.  
  1983.  
  1984.      UDBS Version 5.4                                               Page 34
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.           reset a bulletin flag on a single user, allowing you to monitor
  1991.           if that user has re-read a particular system bulletin.
  1992.  
  1993.           When you select this function you will be presented with a menu
  1994.           asking you which bulletin flag you wish to reset. After you
  1995.           select the flag, another menu will appear asking if you wish to
  1996.           delete all flags (Global), or a single user's flag. If you choose
  1997.           the Global option, all of the flags for this bulletin will be
  1998.           reset to 'no' state. If you choose single user, you will be
  1999.           prompted for a name. Enter the name, if the name if found, the
  2000.           bulletin flag will be reset. If the name is not found, a menu of
  2001.           close matches will be presented to you. Picking a name from this
  2002.           list resets the bulletin flag for that name.
  2003.  
  2004.      Merge Two Data Records
  2005.  
  2006.           This selection give you the ability to merge an older data record
  2007.           into a newer one. The typical use would be when a user name has
  2008.           changed and two data records for the same physical person exist.
  2009.  
  2010.           When you select this function, you will first be asked for the
  2011.           primary data record. This is the record you will be keeping. The
  2012.           data from the second record will be merged into this record. You
  2013.           may enter a full or partial name as with other functions. If a
  2014.           partial name is entered, you will be presented with a list of
  2015.           close matches. After you enter the primary record name, you will
  2016.           be asked to enter the merge record. Again you may enter a full or
  2017.           partial name. After both records have been selected, you will be
  2018.           asked to confirm the merge. The default answer to this question
  2019.           is No. After the merge take place, the second record is deleted.
  2020.           All numerical information is summed into the respective fields of
  2021.           the first record and the file transfers from the second record
  2022.           are added to the end of the list of the primary record.
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.      UDBS Version 5.4                                               Page 35
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.                                Problems & Support
  2050.  
  2051.      This program was written in my spare time as a hobby, this is not a
  2052.      full time business for me. I do take my programs seriously, so I will
  2053.      of course try my best to fix any problems you may turn up. However, I
  2054.      cannot fix what I cannot duplicate. If I cannot duplicate your
  2055.      situation, please be prepared to submit to me copies of your database
  2056.      files, callers log, or whatever else might be required (Once I needed
  2057.      someone's USERS file). I am not interested in the content of these
  2058.      files, only the condition causing the problem. If you cannot agree to
  2059.      this then the condition may have to go unsolved until either I come
  2060.      across it by chance, or another user finds it and cooperates. 
  2061.  
  2062.      How to reach me:
  2063.  
  2064.           On the SailBoard BBS (Wayne, NJ). The number is 1-201-831-8152.
  2065.           This is my home board. The UDBS conference is #4. Registered
  2066.           users also receive support via the system's USR Courier HST.
  2067.  
  2068.           At the address in the beginning of this manual.
  2069.  
  2070.      The UDBS conference (#4) on the SailBoard is set up as the dis-
  2071.      tribution area for all registered software. If you call with a problem
  2072.      report or leave it on the network, please leave the exact version
  2073.      number and name of the program in your message. It would also be
  2074.      helpful to provide the file size and time/date stamp. Try to be
  2075.      specific with your description of the problem. All programs are
  2076.      subject to change without notice. You should REGULARLY check the UDBS
  2077.      support conference on the SailBoard for news of periodic updates and
  2078.      fixes. I  DO MAKE periodic fixes especially to Useact to keep it in
  2079.      step with PCBoard. Most of these fixes are very important to keep
  2080.      Useact working properly with all the changes that are made to the log
  2081.      in PCBoard updates.
  2082.  
  2083.                                 Acknowledgements
  2084.  
  2085.      I would like to thank the following people for their help:
  2086.  
  2087.           Richard Jerothe, Sysop of the SailBoard (1-201-831-8152) for
  2088.           letting me help Sysop his board. Without this I never would of
  2089.           had access to the files necessary for the development of this
  2090.           program.
  2091.  
  2092.           To the BETA testers. These Sysops have been the utmost help in
  2093.           furthering the usefulness of these programs, as well as their
  2094.           comments, criticism, suggestions, and good ideas. They have all
  2095.           at one time or another provided help in testing this program.
  2096.           Their cooperation has been extraordinary. They run excellent
  2097.           systems, and you should give them a call.
  2098.  
  2099.                Gerhard Barth, of the Tamiami BBS (813-793-2392)
  2100.                Phil Gordemer, of Compu-Data (609-232-1245)
  2101.  
  2102.      UDBS Version 5.4                                               Page 36
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                Jim Oxford, of Torii Station (405-733-7083)
  2109.                Andy Keeves, of The Executive Network (914-667-4567)
  2110.                Scott Pazur, of the Flea Market (201-446-1665)
  2111.                Mark Rapp, of the MicroSellar (201-239-1346)
  2112.                Gary Thurlow, of Genesis First State PCBoard (302-475-7598)
  2113.                     ...and others.
  2114.  
  2115.           To ALL the registered users, Thanks for your support, and most of
  2116.           all your confidence.
  2117.  
  2118.                                Disclaimer/Warranty
  2119.  
  2120.      Jeff Sumberg makes no warranty of any kind, express or implied,
  2121.      including without limitation, any warranties of merchantability and/or
  2122.      fitness for a particular purpose. Jeff Sumberg shall not be liable for
  2123.      any damages, whether direct, indirect, special or consequential
  2124.      arising from a failure of these programs to operate in the manner
  2125.      desired by the user. Jeff Sumberg shall not be liable for any damage
  2126.      to data or property which may be caused directly or indirectly by use
  2127.      of this program.
  2128.  
  2129.      IN NO EVENT WILL I, Jeff Sumberg, BE LIABLE TO YOU FOR ANY DAMAGES,
  2130.      INCLUDING, BUT NOT LIMITED TO, ANY LOST PROFITS, LOST SAVINGS OR OTHER
  2131.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR IN-
  2132.      ABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANOTHER PARTY.
  2133.  
  2134.      I MAKE NO WARRANTY OR CLAIM THAT THESE PROGRAMS WILL FUNCTION ON EVERY
  2135.      CONCEIVABLE COMBINATION OF HARDWARE AND/OR SOFTWARE.
  2136.                      
  2137.                                    Trademarks
  2138.  
  2139.      DoubleDos is a registered trademark of SoftLogic Solutions Inc.
  2140.  
  2141.      Microsoft is a registered trademark of Microsoft Corporation.
  2142.  
  2143.      DESQview is a registered trademark of Quarterdeck Office Systems.
  2144.  
  2145.      PCBoard is a product of Clark Development Corporation.
  2146.  
  2147.      Taskview is a trademark of Sunny Hill Software.
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.      UDBS Version 5.4                                               Page 37
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.                    Appendix A - Getting Your Database Started
  2168.  
  2169.      Getting started is relatively simple. The first thing you want to do
  2170.      is properly set up your configuration file. Take a look at the sample
  2171.      that came with the programs. Most sites can use the setting of the
  2172.      INPUT= and OUTPUT= parameters as is. If not, simply change the names.
  2173.      You can also add the MBQ=, BULLETINX=, USERS=, and NEWADDITIONS=
  2174.      parameters at this time if you wish. You may have to make adjustments
  2175.      to the supplied language file ENGLISH.UDB, check it's entries to see
  2176.      that they match your PCBTEXT entries. 
  2177.  
  2178.      If you have kept all or some of your back callers logs, the easiest
  2179.      way to get going is to use an indirect input file. First gather all
  2180.      your callers logs together on your hard drive in some convenient
  2181.      subdirectory. Second, using a text editor that creates pure ASCII
  2182.      files, create a file (For this example, we'll call it MYLOGS) with the
  2183.      name of each log file on a separate line. Then, in your UDBS.CFG file,
  2184.      set the INPUT= statement to INPUT=@MYLOGS, then run Useact. Useact
  2185.      will run until it processes all the log files found in MYLOGS.
  2186.  
  2187.      The first time you run Useact you will be asked if you wish to create
  2188.      the database files. Answer 'Yes'. You should now see the analyzer
  2189.      stepping through each call. When the end of the log is reached (or
  2190.      space runs low, whichever comes first), control will pass to the
  2191.      database functions. Here you will see names being added to the
  2192.      database along with the file transfers. When this section completes,
  2193.      Useact will either end, or continue with the next section of the log.
  2194.      When Useact finishes, you will then be able to try out Query.
  2195.  
  2196.      After Useact is finished, you can use the SYNC utility if you desire
  2197.      to set the downloads, uploads, times on, and subscription dates to
  2198.      correspond with your users file.  
  2199.  
  2200.      Please note that if you plan to process multiple callers logs with an
  2201.      indirect file, that you cannot mix logs from versions 10, 11, 12, or
  2202.      14. You must process them separately according to the instructions in
  2203.      the configuration section (see VERSION=).
  2204.  
  2205.      After you have performed this initial setup, you can proceed to setup
  2206.      your event operations. This is covered in the next two Appendices (B &
  2207.      C).
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.      UDBS Version 5.4                                               Page 38
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.                     Appendix B - The NewCalls Utility Program
  2227.  
  2228.      NewCalls.Exe is a utility program designed to make daily database
  2229.      updates simpler than they have been in the past. This program copies
  2230.      the newest section of the callers log to a separate 'extraction' file.
  2231.      This extracted section of the callers log is what is then run through
  2232.      the UDBS database update program 'Useact'. After NewCalls has ex-
  2233.      tracted the section from the callers log, it records the last record
  2234.      extracted from the log (in a control file). When NewCalls is run
  2235.      again, it knows immediately from this recorded record number where to
  2236.      start the new extraction. All new calls (NewCalls) are then extracted
  2237.      from this point till the end of the log file, then the new 'end point'
  2238.      is recorded. This process continues daily in your event, and your
  2239.      original callers log is not  touched. The extracted file is
  2240.      overwritten at the next run of NewCalls, and will never be larger than
  2241.      one days worth of calls (except for perhaps the first run of Newcalls,
  2242.      when the first end point is established). NewCalls contains logic to
  2243.      sense the fact that a new callers log has been created by testing to
  2244.      see if the point of extraction is greater than the number of records
  2245.      in the callers log. If the callers log is deleted, NewCalls resets
  2246.      automatically to record one, and starts over. If NewCalls senses that
  2247.      the log is the same size as the last run, no records are extracted,
  2248.      and NewCalls ends.
  2249.  
  2250.      This program uses the premise that the callers log is a fixed record
  2251.      length random access file. These records are 64 characters in length
  2252.      containing 62 significant characters (the logged data) followed by a
  2253.      Carriage Return and Line Feed (62 + CR/LF = 64). Therefore anything
  2254.      that writes to the log (including ALL third party programs) MUST
  2255.      maintain this system. All programs that I know of do, otherwise you
  2256.      would see problems when you do the Sysops command "1 V" to view the
  2257.      log in reverse order. If records were less or greater in length, lines
  2258.      would appear out of sync (split in the middle). The same goes for this
  2259.      program. If any records are more or less than 64 characters, then ALL
  2260.      lines after that point will be improperly extracted.
  2261.  
  2262.      It should be noted that if you create a callers log that is only 1 day
  2263.      in length (deleted at each event), then this program should not be
  2264.      used. This program is for Sysops that keep an ongoing daily log, and
  2265.      delete it at some random time (weekly, monthly, etc.).
  2266.  
  2267.      NewCalls is driven off the command line, it does not read or use the
  2268.      UDBS configuration file. NewCalls has the following format:
  2269.  
  2270.           NEWCALLS controlfile callerslog extractfile
  2271.  
  2272.      Before you can use NewCalls in your event, you must first initialize
  2273.      the control file. If you fail to do this step first, then NewCalls
  2274.      will 'hang' your event waiting for a response from you. Initialize
  2275.      your control file as follows:
  2276.  
  2277.           NEWCALLS Node.Rec x x
  2278.  
  2279.      UDBS Version 5.4                                               Page 39
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.      Notice that THREE parameters are supplied here also. In this case two
  2287.      'x' characters are used to fill the input and output file spaces, in
  2288.      actual use these would be valid file names. the control file name
  2289.      'Node.Rec' is arbitrary, and you can select ANY valid filename. Multi-
  2290.      node systems will generate one control file for each node (to record
  2291.      the last position of each callers log). This file is written in the
  2292.      current directory, which in most cases is your UDBS directory (but
  2293.      does not need to be). When NewCalls detects that no control file
  2294.      exists, it will prompt you to be sure that you want to initialize a
  2295.      new file with the name you specified. Answering 'Yes' to the prompt
  2296.      creates and initializes the control file. You are now ready to place
  2297.      NewCalls in your event.
  2298.  
  2299.      Add the call(s) to the NewCalls program to your event before you call
  2300.      Useact. For this example I'm assuming a standard single node PCBoard
  2301.      setup using the standard directories. The syntax would be:
  2302.  
  2303.           NEWCALLS Node.Rec \PCB\MAIN\CALLER EXTRACT
  2304.  
  2305.      In this example NewCalls will read the control file 'Node.Rec' and
  2306.      create an output file called EXTRACT. Again, the name EXTRACT is
  2307.      arbitrary and may be any name you choose, it can even be directed to
  2308.      another drive or directory. 
  2309.  
  2310.      So, as an example, your Event.Sys might look like this:
  2311.  
  2312.           .
  2313.           .
  2314.           .
  2315.           Newcalls Node.Rec \PCB\MAIN\CALLER EXTRACT
  2316.           Useact
  2317.           Sync /F        (Optional step, see Appendix C)
  2318.           .
  2319.           .
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.      UDBS Version 5.4                                               Page 40
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.                   Appendix C - Setup For Multiple Node Systems
  2345.  
  2346.      If you have not already read "Appendix B - The Newcalls Program",
  2347.      please go back and do it now. Newcalls is used for multiple node
  2348.      systems and an understanding of how Newcalls extracts sections from
  2349.      callers logs is necessary.
  2350.  
  2351.      If you run two or more nodes, you would create multiple control files.
  2352.      You could for example name the control files 'Node1.Rec', 'Node2.Rec',
  2353.      etc. However there are three methods to process the output from
  2354.      Newcalls.
  2355.  
  2356.      The first method uses one extract file, which is overwritten by the
  2357.      next run of Newcalls. For this method your event file would look like
  2358.      this:
  2359.  
  2360.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT
  2361.           Useact
  2362.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT
  2363.           Useact
  2364.  
  2365.      For method one, remember to set the INPUT= statement in your UDBS.CFG
  2366.      file to reflect the name of the file you are using as the extract
  2367.      file, which in this example is EXTRACT.
  2368.  
  2369.      The second method uses multiple extract files, and your event would
  2370.      contain:
  2371.  
  2372.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT.1
  2373.           Useact INPUT=EXTRACT.1
  2374.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT.2
  2375.           Useact INPUT=EXTRACT.2
  2376.  
  2377.      There is no real difference in operation for method one or two. Notice
  2378.      however the use of the INPUT= statement on Useact's command line to
  2379.      tell it the name of the input file. Both run Useact twice, and create
  2380.      two (or more) period total entries in the Master.Dat file, each one
  2381.      being the daily usage for each node. If you were using a LOG=
  2382.      statement these two methods would create a log entry for each Useact
  2383.      run with information on each extract file.
  2384.  
  2385.      The third method uses multiple extract files and an indirect file to
  2386.      supply the names of the extract files to Useact. For this method your
  2387.      event would contain:
  2388.  
  2389.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT.1
  2390.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT.2
  2391.           NewCalls Noden.Rec \PCB\MAIN\CALLERn EXTRACT.n
  2392.           Useact INPUT=@MYLOGS
  2393.  
  2394.      This method is probably the simplest of them all. In this method,
  2395.      Useact only runs once and would probably be the quickest of the three
  2396.  
  2397.      UDBS Version 5.4                                               Page 41
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.      methods. However this method only creates one period total in
  2404.      Master.Dat, which would be the total usage for all your nodes. If you
  2405.      were using a LOG= statement with this method, only one log entry would
  2406.      be created, which again would contain total usage for all nodes. Be
  2407.      sure you understand the usage of indirect files if you plan to use
  2408.      this method. Indirect input files are explained in detail on page 9.
  2409.  
  2410.      Other than the number of period totals generated in Master.Dat, all
  2411.      three methods generate the same amount of user information in the
  2412.      database.
  2413.  
  2414.      Choose the method that best suits your situation and PCBoard site.
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.      UDBS Version 5.4                                               Page 42
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.                           Appendix D - The Sync Utility
  2463.  
  2464.      This utility is used to set the upload, download, registration date,
  2465.      and times on system counts for a user to be the same as the values
  2466.      stored in the Users file. When a user is first added to the database,
  2467.      all counts start at zero. But this user may have been on your system
  2468.      numerous times in the past, and might have many file transfers. If you
  2469.      save your past callers logs you could initialize your database this
  2470.      way (This would be the best way). Otherwise you would then run this
  2471.      program to set this users record 'up to date' with his past activity.
  2472.      Of course the names of the past file transfers will be unknown, and
  2473.      the total time value off, but at least the transfer counts are
  2474.      accurate. The registration date found in the PCBoard users file will
  2475.      be copied into the UDBS files if it is set to something other than
  2476.      zero (if the UDBS file contains a date, and the USERS file date is
  2477.      zero, the UDBS file will also be reset to zero). This way you only
  2478.      need to enter registration or subscription dates in one place, and can
  2479.      still utilize the subscription functions of UDBS.
  2480.  
  2481.      This program can be run in three ways. The first two are interactive
  2482.      and is done from the command line. When you run the program in this
  2483.      way you will be given the choice to modify one user, or do the entire
  2484.      database.
  2485.  
  2486.      The third way is out of EVENT.SYS (batch mode), and this is probably
  2487.      the best way as it does the entire database daily (or whenever), and
  2488.      it does it without your intervention. To use the batch mode add the
  2489.      following line to EVENT.SYS (if you use automatic daily update as
  2490.      explained earlier, place this line after the update):
  2491.  
  2492.           SYNC /F
  2493.  
  2494.        Note:   You cannot use the SYNC program in you are running version
  2495.                10 of PCBoard because of the differences in the USERS file.
  2496.                See the note under the Version=10 parameter.
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.      UDBS Version 5.4                                               Page 43
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.                           Appendix E - Common Problems
  2522.  
  2523.      Here is a list of common problems people have encountered, and their
  2524.      typical solutions.
  2525.  
  2526.      Problem:  The first 3 characters of every user name are missing.
  2527.  
  2528.      Solution: You are using a single node version of PCBoard (ie: /S, /D,
  2529.                or /En version with no network) and you forgot to add the
  2530.                line "SINGLENODE" to your UDBS.CFG configuration file.
  2531.  
  2532.      Problem:  Useact stops during the event, hangs my system up all night
  2533.                waiting to tell me about possible record duplication.
  2534.  
  2535.      Solution: Something is wrong with the way you split the daily log
  2536.                file(s) up so that an overlap of time/dates is occurring.
  2537.                Another common reason is you are running a Multi-Node system
  2538.                and re processing two (or more) logs together from the same
  2539.                24 hour period and didn't use the "OVERLAPCHECK=NO"
  2540.                parameter in the UDBS.CFG file.
  2541.  
  2542.      Problem:  Useact Stops during the event, hangs the system up again
  2543.                with the error message "Illegal Function Call".
  2544.  
  2545.      Solution: Add the line "EVENT" to the UDBS.CFG file to instruct Useact
  2546.                to ignore the error and continue.
  2547.  
  2548.      Problem:  You want to delete all user comments.
  2549.  
  2550.      Solution: DO NOT delete the comments file (Comments.Dat). Use the
  2551.                "Delete All Comments" function located in the comments
  2552.                selection of the file maintenance menu.
  2553.  
  2554.      Problem:  Useact doest count certain items correctly, or at all.
  2555.  
  2556.      Solution: If you changed certain text lines that are written to the
  2557.                callers log with the MKPCBTXT program, Useact does not
  2558.                recognize then new line. Therefore its as if it never
  2559.                occurred in the log. My feeling is you shouldn't change
  2560.                standard responses. A file containing all scanned text is
  2561.                available on request.
  2562.  
  2563.      Problem:  I get a "Bad Record Number" error or an "Error #63" message.
  2564.  
  2565.      Solution: Your data files have become corrupted because they were not
  2566.                closed properly after being updated. There is NO cure for
  2567.                this condition except a BACKUP copy. If Useact, Modify, or
  2568.                Up/Downcred are interrupted/booted/power loss/crash/etc
  2569.                while updating files ASSUME the files are bad and use your
  2570.                current backup.
  2571.  
  2572.  
  2573.  
  2574.      UDBS Version 5.4                                               Page 44
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.      Problem:  "I know somebody downloaded a certain file, I see it in the
  2581.                callers log. But when I go to function G in Query [Who
  2582.                Downloaded...] I see user names, but not the one I saw do
  2583.                the download. Why?"
  2584.  
  2585.      Solution: Because of a bug caused by a caller log format change around
  2586.                May/June 1990, Useact 5.25 parsed 12 character file names
  2587.                with an extra space (13 character). This awakened a dormant
  2588.                bug in the index library which caused Useact to create a new
  2589.                transfer record. However this new transfer record was not
  2590.                connected to the existing transfer records for that
  2591.                filename, so you don't see them. This can be fixed with the
  2592.                REPAIRDL utility. NOTE: If the REPAIRDL utility is not
  2593.                within this ZIP file, please contact me for it.
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.      UDBS Version 5.4                                               Page 45
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.                      Appendix F - What Registered Users Get
  2640.  
  2641.      Aside from getting full support, you also have the ability to suggest
  2642.      new additions to be implemented into UDBS. When you register your copy
  2643.      of the User Database System you will receive the following additional
  2644.      programs:
  2645.  
  2646.      QRYDOOR   This is the user inquiry door. This door allows the user to
  2647.                view their own personal system statistics. They may also
  2648.                view their download and upload transfer list. This is
  2649.                similar to function A in the Query program.
  2650.  
  2651.      UPLDOOR   This is the upload inquiry door. Users will be allowed to
  2652.                ask "who uploaded this file" to your system. They will be
  2653.                shown the name of the uploader, the date of the upload, and
  2654.                if any downloads (how many) have been made on the file. This
  2655.                program is similar to several competitors programs that use
  2656.                Download.Txt, except the Upldoor finds the information
  2657.                immediately from the database, it doesn't have to scan for
  2658.                it.
  2659.  
  2660.      DOWNCRED  Do you run a system that has download ratios? If so then
  2661.                this program is for you. Using this program you can offer
  2662.                ratio-free programs to your users. It could perhaps be your
  2663.                master file list, or some special file you want to offer to
  2664.                your users. This program runs in the event and credits the
  2665.                download automatically in both the UDBS and USERS files. The
  2666.                program can also be used to help keep your database free of
  2667.                junk such as Qwikmail downloads (*.QWK files). In this case
  2668.                Downcred will remove the file from UDBS but not credit the
  2669.                USERS file.
  2670.  
  2671.      UPCRED    Similar to Downcred. Primarily used to remove repetitive
  2672.                uploads of the same file from your database (Such as Qwik-
  2673.                mail *.REP files).
  2674.  
  2675.      CMTUTIL   This program copies the comment fields in your USERS file to
  2676.                the UDBS comment fields. This way any comments that your
  2677.                users enter (such as addresses, machine/modem type, etc) are
  2678.                viewable when a users record is viewed. The user can also
  2679.                see the public comment field when the Query door is run.
  2680.                This program runs during your event.
  2681.  
  2682.      Several other minor utilities are available to all users. These are
  2683.      posted on the Sailboard BBS. Other utilities are planned for the
  2684.      future.
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.      UDBS Version 5.4                                               Page 46
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.                                       Index
  2699.  
  2700.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2701.      Add Download Credit . . . . . . . . . . . . . . . . . . . . . . . . 32
  2702.      Add Upload Credit . . . . . . . . . . . . . . . . . . . . . . . . . 32
  2703.      All Files Downloaded By A Specific User . . . . . . . . . . . . . . 26
  2704.      All Files Uploaded By A Specific User . . . . . . . . . . . . . . . 26
  2705.      Alloy's PC/slave card . . . . . . . . . . . . . . . . . . . . . . .  7
  2706.      Backups
  2707.           Automatic  . . . . . . . . . . . . . . . . . . . . . . . . 11, 30
  2708.           Filenames Of . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2709.           Importance of  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2710.           Inhibiting . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2711.      Baud Rates  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2712.      BULLETINx=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2713.      Change User Name  . . . . . . . . . . . . . . . . . . . . . . . . . 32
  2714.      Command Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . 24
  2715.      Comments  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
  2716.           Delete All Comments  . . . . . . . . . . . . . . . . . . . . . 34
  2717.           Enter/Change/Delete  . . . . . . . . . . . . . . . . . . . . . 33
  2718.           Scan For Text  . . . . . . . . . . . . . . . . . . . . . . . . 34
  2719.      COMMENTS.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2720.      Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . 44
  2721.      Config.Sys  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2722.      Configuration Parameters, Where Used  . . . . . . . . . . . . . . . 22
  2723.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . . .  6
  2724.      Database Files, Location of . . . . . . . . . . . . . . . . . . . . 12
  2725.      Database Size Information . . . . . . . . . . . . . . . . . . . . . 32
  2726.      DATABASE.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2727.      Delete Download Credit  . . . . . . . . . . . . . . . . . . . . . . 32
  2728.      Delete If Not In User File  . . . . . . . . . . . . . . . . . . . . 30
  2729.      Delete Upload Credit  . . . . . . . . . . . . . . . . . . . . . . . 32
  2730.      Delete User . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2731.      DesqView  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 37
  2732.      Display New Users Only  . . . . . . . . . . . . . . . . . . . . . . 12
  2733.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . . .  6
  2734.      Doors and Node Chat . . . . . . . . . . . . . . . . . . . . . . . . 27
  2735.      DoubleDos . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 37
  2736.      DOWNLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2737.      DOWNLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2738.      Error Handling in Useact  . . . . . . . . . . . . . . . . . . . . . 23
  2739.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . . . 30
  2740.      File Transfers During a Specific Period . . . . . . . . . . . . . . 26
  2741.      Filename.HDR  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2742.      Filename.IDX  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2743.      FILES=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2744.      Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . 38
  2745.      Index File Names  . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2746.      Index File Structure  . . . . . . . . . . . . . . . . . . . . . . .  8
  2747.      Indirect Input FIles  . . . . . . . . . . . . . . . . . . . . . . .  9
  2748.      INPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2749.      Language File Format  . . . . . . . . . . . . . . . . . . . . . . . 20
  2750.  
  2751.      UDBS Version 5.4                                               Page 47
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.      Languages=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  2758.      LanguageX=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  2759.      License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  2760.      LOG=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2761.      MASTER.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2762.      MBQ=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2763.      Merge Two Data Records  . . . . . . . . . . . . . . . . . . . . . . 35
  2764.      Microsoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  2765.      Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2766.      MKPCBTXT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  2767.      MODIFY.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 30
  2768.      Monitoring Bulletins Read . . . . . . . . . . . . . . . . . . . . . 14
  2769.      Network File Access . . . . . . . . . . . . . . . . . . . . . . 11, 13
  2770.      NEW=YES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2771.      NEWADDITIONS=NO . . . . . . . . . . . . . . . . . . . . . . . . 13, 28
  2772.      NewCalls Utility Program  . . . . . . . . . . . . . . . . . . . . . 39
  2773.      OUTPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2774.      OVERLAPCHECK= . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2775.      PATH Statement (DOS)  . . . . . . . . . . . . . . . . . . . . .  7, 17
  2776.      PCBNDX= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2777.      PCBoard
  2778.           Beta Releases  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2779.           Bulletins  . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2780.           Changes, To Callers Log  . . . . . . . . . . . . . . . . . . .  8
  2781.           Changes, To USERS File . . . . . . . . . . . . . . . . . . . . 13
  2782.           Event.Sys  . . . . . . . . . . . . . . . . . . . . . . . . 17, 23
  2783.           Multi-Node Systems, Restrictions . . . . . . . . . . . . . . . 11
  2784.           Multi-Node Systems, Setup  . . . . . . . . . . . . . . 16, 41, 44
  2785.           Single Node Systems  . . . . . . . . . . . . . . . . . . . . . 16
  2786.           Trademark  . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  2787.           USERS File, Record Length  . . . . . . . . . . . . . . . . . . 15
  2788.           USERS file, Where Its Used . . . . . . . . . . . . . . 12, 15, 30
  2789.      PCBTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  2790.      Period Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  2791.      Preventing Database Additions . . . . . . . . . . . . . . . . . . . 13
  2792.      Problem Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2793.      Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2794.      Purify  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 30
  2795.           Stopping . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2796.           What It Does . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2797.      PURIFYBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2798.      QUERY.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 25
  2799.      QuickBasic run-time library . . . . . . . . . . . . . . . . . . . .  7
  2800.      Rebuild Index Files . . . . . . . . . . . . . . . . . . . . . . . . 34
  2801.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  2802.      REPORT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  2803.      Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2804.      Reset Bulletin Flag . . . . . . . . . . . . . . . . . . . . . . . . 34
  2805.      RESETBUL.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2806.      Restrictions  . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  2807.      SailBoard BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2808.      Scan For User Name  . . . . . . . . . . . . . . . . . . . . . . . . 29
  2809.  
  2810.      UDBS Version 5.4                                               Page 48
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.      Setup For Multiple Node Systems . . . . . . . . . . . . . . . . . . 41
  2817.      Show New Users On Specified Date  . . . . . . . . . . . . . . . . . 29
  2818.      SINGLENODE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2819.      Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
  2820.      Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2821.      Sync Utility  . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
  2822.      SYNC.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  2823.      System Requirements . . . . . . . . . . . . . . . . . . . . . . . .  7
  2824.      Taskview  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 37
  2825.      Text Matching Rules . . . . . . . . . . . . . . . . . . . . . . . . 21
  2826.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  2827.      UDBS.CFG  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2828.      UDBS50.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2829.      Undelete User . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2830.      UPDATE=YES  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2831.      UPLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2832.      UPLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2833.      USEACT.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 23
  2834.      USEACTBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2835.      User Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  2836.      Users Disconnected For Daily Time Limit . . . . . . . . . . . . . . 26
  2837.      Users Exceeding DL/UL Ratio . . . . . . . . . . . . . . . . . . . . 27
  2838.      Users That Downloaded A Specific File . . . . . . . . . . . . . . . 26
  2839.      Users That Never Left A Message . . . . . . . . . . . . . . . . . . 27
  2840.      Users That Page Sysop . . . . . . . . . . . . . . . . . . . . . . . 29
  2841.      Users Who Never Download  . . . . . . . . . . . . . . . . . . . . . 25
  2842.      Users Who Never Upload  . . . . . . . . . . . . . . . . . . . . . . 25
  2843.      Users With Keyboard Timeout Disconnects . . . . . . . . . . . . . . 26
  2844.      Users With Security Violations  . . . . . . . . . . . . . . . . . . 28
  2845.      USERS=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2846.      VERSION=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  2847.      What Isn't Supported  . . . . . . . . . . . . . . . . . . . . . . .  8
  2848.      What Registered Users Get . . . . . . . . . . . . . . . . . . . . . 46
  2849.      Who Uploaded A Specific File  . . . . . . . . . . . . . . . . . . . 26
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.      UDBS Version 5.4                                               Page 49